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.

Ulrik could you please submit a patch?

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.

Other useful advice:
http://docs.pythonsprints.com/core_development/beginners#building-the-documentation
http://docs.python.org/documenting/

Wrong link, sorry everyone for the noise:
http://docs.pythonsprints.com/core_development/beginners.html#building-the-documentation

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.

Fixed markup a bit and committed in r85538.  Thanks!