[New-bugs-announce] [issue10446] pydoc3 links to 2.x library reference

Alexander Belopolsky 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

assignee: belopolsky
components: Documentation, Library (Lib)
messages: 121365
nosy: belopolsky
priority: normal
severity: normal
status: open
title: pydoc3 links to 2.x library reference
type: behavior
versions: Python 3.1, Python 3.2

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list