[issue10446] pydoc3 links to 2.x library reference
report at bugs.python.org
Wed Nov 17 18:32:23 CET 2010
New submission from Alexander Belopolsky <belopolsky at users.sourceforge.net>:
$ pydoc3.1 pydoc
Help on module pydoc:
pydoc - Generate Python documentation in HTML or text for interactive use.
I suggest changing the default base URL to
I would also like to take this opportunity and make some other improvements:
1. Clarify that the linked document is the authoritative reference and that generated documentation may expose functions that are considered internal and subject to change or removal. (Suggestions for an exact wording are welcome.)
2. Move the FILE section to the end. This will free up some screen space for an expanded "AUTHORITATIVE REFERENCE" section. (Yes, I think the section title "MODULE DOCS" can be improved, but my mind is not set on any particular alternative.)
3. Do not include __special__ names in the DATA section. At the very least, exclude __author__, __version__, and other special names that cause generation of document sections:
__author__ = 'Ka-Ping Yee <ping at lfw.org>'
__credits__ = 'Guido van Rossum, for an excellent programming l...erla...
__date__ = '26 February 2001'
__version__ = '$Revision: 78210 $'
26 February 2001
components: Documentation, Library (Lib)
title: pydoc3 links to 2.x library reference
versions: Python 3.1, Python 3.2
Python tracker <report at bugs.python.org>
More information about the Python-bugs-list