[docs] [issue11975] Fix referencing of built-in types (list, int, ...)

Jonas H. report at bugs.python.org
Mon May 30 16:38:41 CEST 2011


Jonas H. <jonas at lophus.org> added the comment:

> when you mark up something with a mod, func, class or meth role, Sphinx will find the target without paying attention to its type.  So changing :func: to :class: does not bring anything.

>From a quick test this seems to hold true for links within one project but not for Sphinx' intersphinx extension, which actually cares about types.

So the question is whether we keep CPython implementation details (many builtins being both a class and a function) out of the documentation or we get the Sphinx developers to change intersphinx behaviour.  I guess you'd suggest the latter, right? :-)

----------

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


More information about the docs mailing list