Generating more useful Python API docs

[Jonathan Robie]

I'm trying to figure out if there is a relatively easy way to generate 
more useful Python API docs.

Many of the methods you actually want to use are created when loading 
the spec files at run time, and do not show up in the pydoc. That makes 
it pretty hard to know what methods you can call by looking at the pydoc.

I suppose one approach would be to creat HTML files using pydoc, then 
merge in some information from the spec files. Are there other 
approaches worth considering?

Jonathan