Tony Ibbs <tibs@...> writes:
> epydoc will, I believe, handle reStructuredText as well as its own
> format (a quick looks says it only claims proper support for output
> to HTML),
I can confirm that epydoc handles reStructuredText.
> but if I remember it imports the python code, rather than just
> parsing it. If true, this may or may not matter to you (it depends a
> bit on the code you're working with).
aye, last I checked, the parsing didn't buy you much (that is, you
still had to explicitly document everything to get the API doc). And
the importing can be a liability in terms of making things more
All that said, at my last search, epydoc seemed the best option for
API doc generation with rst with Python.