[issue10446] pydoc3 links to 2.x library reference

Éric Araujo report at bugs.python.org
Thu Nov 18 01:28:03 CET 2010


Éric Araujo <merwok at netwok.org> added the comment:

Looks good.  Some remarks:

1) I assume you have checked that this code does not produce two newlines (one in the string, one from the print function or write method):
+[snip], consult the module reference at the location listed above.
+""")

2) “If you can suggest some simple test for pointing to 'dev' instead of 'release/X.Y'” → sys.version_info[3] != 'final'

3) People seem to go the the most recent version of the docs, not the release-specific version (I haven’t found the python-dev thread about that, maybe you remember it).  The version{add,chang}ed directives help adjust the doc for older versions.  So, are you sure it’s useful to make the links release-specific?

----------

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


More information about the Python-bugs-list mailing list