This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients docs@python, eric.araujo, georg.brandl, ron_adam, techtonik, terry.reedy
Date 2011-03-09.02:38:23
SpamBayes Score 7.3703594e-09
Marked as misclassified No
Message-id <1299638304.2.0.761764097359.issue7798@psf.upfronthosting.co.za>
In-reply-to
Content
I have looked at the pydoc module.  Everything except help() is intended to be private. The author says within the file that __all__, when present, defines public interface and uses that definition within help() to decide what to display. So I do not think anything else should be documented unless it is made 'public' by being added to pydoc.__all__ or moved to another module. In either case, the result would be a new code feature. Doc addition would naturally follow. Also, if a function is made public, the interface and code could be reconsidered for possible modification for general usage.
History
Date User Action Args
2011-03-09 02:38:24terry.reedysetrecipients: + terry.reedy, georg.brandl, techtonik, ron_adam, eric.araujo, docs@python
2011-03-09 02:38:24terry.reedysetmessageid: <1299638304.2.0.761764097359.issue7798@psf.upfronthosting.co.za>
2011-03-09 02:38:23terry.reedylinkissue7798 messages
2011-03-09 02:38:23terry.reedycreate