Jonathan Robie wrote:
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
Jonathan,
I seem to recall using a tool called amqp-doc (in qpid/python) to
generate pydoc-style output for the AMQP specification. This output
included the "generated" parts of the API.
Unfortunately, that tool doesn't seem to work in the latest SVN.
-Ted