New submission from Ben Finney:

The library documentation for ‘pydoc’ expects that the ‘pydoc’ module will only 
ever be run as a command-line program. This ignores the general usefulness of 
several of the functions in that module when imported from the library.

The documentation should describe at least the following functions:

* pydoc.getdoc

* pydoc.synopsis

* pydoc.splitdoc

The following would be useful also:

* pydoc.classname

* pydoc.cram

* pydoc.allmethods

----------
assignee: docs@python
components: Documentation
messages: 197138
nosy: bignose, docs@python
priority: normal
severity: normal
status: open
title: Document useful functions in ‘pydoc’ module
type: enhancement
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 
3.4, Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue18956>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to