[issue12298] Sphinx glitch in library/functions

[Terry J. Reedy]

Terry J. Reedy <tjreedy at udel.edu> added the comment:

I agree that all table entries should link to the entry in the same file.

dict() and set() also jump to CH. 4, in addition to memoryview and frozenset. Others all work properly.

The entries for classes should generally have a link to their section in '4. Built-in Types'. All do other than these:

range() definitely needs a forward reference to 4.6 sequence types 

bool() lacks forward references; it could have one to 4.2 Bool ops and 4.11.9 Bool values

object() -- no where to go.

slice() only has a reference to the glossary; it has no entry in Ch.4. "Slice objects have read-only data attributes start, stop and step which merely return the argument values (or their default). They have no other explicit functionality" is slightly wrong since there is the .indices method.

type(n,b,d) has no forward references as there is no where to go exactly

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12298>
_______________________________________