[issue9364] some problems with the documentation of pydoc

R. David Murray added the comment: Thanks, Glenn. I tweaked the wording further. If someone thinks it is worth the effort to backport this to 2.7, they can do so and reopen the issue. -- assignee: eric.araujo -> nosy: +r.david.murray resolution: -> fixed stage: needs patch -> resolv

[issue9364] some problems with the documentation of pydoc

Roundup Robot added the comment: New changeset 16207b8495bf by R David Murray in branch '3.4': #9364: Improve the text printed by help(pydoc) and help(help). http://hg.python.org/cpython/rev/16207b8495bf New changeset 256c782ab078 by R David Murray in branch 'default': Merge: #9364: Improve the

[issue9364] some problems with the documentation of pydoc

Glenn Jones added the comment: I have added patches that replace the previous ones and apply to head. It appears that the other changes discussed (crosslinking and improving documentation) have already been done. -- nosy: +Glenn.Jones ___ Python tra

[issue9364] some problems with the documentation of pydoc

Changes by Glenn Jones : Added file: http://bugs.python.org/file34948/pydoc-2.patch ___ Python tracker ___ ___ Python-bugs-list mailing list Un

[issue9364] some problems with the documentation of pydoc

Changes by Glenn Jones : Added file: http://bugs.python.org/file34947/_sitebuiltins-2.patch ___ Python tracker ___ ___ Python-bugs-list mailing

[issue9364] some problems with the documentation of pydoc

Changes by Nilovna Bascunan-Vasquez : -- nosy: +nilovna ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://

[issue9364] some problems with the documentation of pydoc

Éric Araujo added the comment: yeswanth, would you like more guidance or should I finish the patches? -- ___ Python tracker ___ ___ Py

[issue9364] some problems with the documentation of pydoc

Changes by yeswanth : Added file: http://bugs.python.org/file20703/site.diff ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscri

[issue9364] some problems with the documentation of pydoc

Changes by yeswanth : Removed file: http://bugs.python.org/file20700/site.diff ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubsc

[issue9364] some problems with the documentation of pydoc

Changes by Éric Araujo : -- assignee: docs@python -> eric.araujo ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue9364] some problems with the documentation of pydoc

Éric Araujo added the comment: See http://docs.python.org/dev/documenting/ (see also http://docs.python.org/devguide/patch for process guidelines). Note about site.diff: -"""Define the builtin 'help'. -This is a wrapper around pydoc.help (with a twist). +"""Class used to implement

[issue9364] some problems with the documentation of pydoc

yeswanth added the comment: Completely agreed with you on having "Welcome to python 3.2 help!".. made the changes. Uploaded site.py as suggested by you . I will try to create the patch for the links , but i am not sure how to .Could use some help if you can provide me any website link.Thanks

[issue9364] some problems with the documentation of pydoc

Changes by yeswanth : Added file: http://bugs.python.org/file20699/pydoc.diff ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscr

[issue9364] some problems with the documentation of pydoc

Changes by yeswanth : Removed file: http://bugs.python.org/file20686/pydoc.diff ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubs

[issue9364] some problems with the documentation of pydoc

Éric Araujo added the comment: > Welcome to Python 3.2! This is the online help utility. > which could be changed to > Welcome to Python help utility Agreed. I assume this dates back to a time where “online help” meant available on this computer, not on some global network. I’d keep the ve

[issue9364] some problems with the documentation of pydoc

yeswanth added the comment: Patch for the change i have suggested in pydoc . @Eric I will try to implement the patch suggestions you have made. I still have to figure out how to make crosslinks -- keywords: +patch Added file: http://bugs.python.org/file20686/pydoc.diff ___

[issue9364] some problems with the documentation of pydoc

yeswanth added the comment: Suggestions are good . One thing I came across when going through the doc is that when you run help(help) after importing help from pydoc , i noticed that the first line of the help utility is """ Welcome to Python 3.2! This is the online help utility. """ which

[issue9364] some problems with the documentation of pydoc

Eli Bendersky added the comment: Éric - your suggestions look good to me. The correspondence with Terry was on July 16th, 2010 - maybe he can remember which thread in pydev it was exactly. -- ___ Python tracker

[issue9364] some problems with the documentation of pydoc

Changes by Ron Adam : -- nosy: +ron_adam ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/

[issue9364] some problems with the documentation of pydoc

Éric Araujo added the comment: >> In the Python interpreter, do "from pydoc import help" to provide online >> help. Calling help(thing) on a Python object documents the object. > Which is no longer accurate, because the help() function has long ago > become a built-in. To be pedantic, help is n

[issue9364] some problems with the documentation of pydoc

Changes by Florent Xicluna : -- keywords: +easy nosy: +flox stage: -> needs patch ___ Python tracker ___ ___ Python-bugs-list mailing

[issue9364] some problems with the documentation of pydoc

New submission from Eli Bendersky : The first paragraph in its documentation says: """ In the Python interpreter, do "from pydoc import help" to provide online help. Calling help(thing) on a Python object documents the object. """ Which is no longer accurate, because the help() function has lo