The module pkgutil has no documentation of functions added after its introduction, in the official python documentation collection. http://docs.python.org/dev/py3k/library/pkgutil.html The module is well documented with docstrings. I assume the module's exposed functions, some very useful, are open for public use, for example pkgutil.iter_modules and .walk_packages. Is all that is required copying the docstrings into the documentation? If someone believes only Python insight and knowledge of reST sytax is enough to make some passable documentation from the existing docstrings, I could submit a patch for that.
Thanks for your help proposal Ulrik. If I understand the documentation correctly, docstrings should contain enough usage information but not too much. In pkgutil, some examples and long explanations could be removed after you move them to the reST doc. Make sure to work from a checkout of 3.2 (branch named py3k) to have the latest updates. This page contains some tips about patches: http://www.python.org/dev/patches/ You can ask any questions here or on the docs@python.org mailing list. Thanks again.
I've taken the liberty of creating a patch for this issue. I've taken the docstrings fromt he pkgutil module and conveted them to reST. Please let me know if there are any changes necessary.
