Message130400
| 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. |
|