For best results use StructuredText markup in your docstrings.
Many people seems to have problems running pythondoc.
It is very important to know pythondoc is mostly implemented as a package. On the Windows platform it is probably best to rename this to 'pdoc.py' and move it to a directory in your path. On Unix, the Makefile install rule should take care of setting up everything for you. This version has formatters for a homegrown XML format, and HTML 4.0. Crossreferencing modules may be plugged in to support references to external systems.