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.
Get latest updates about Open Source Projects, Conferences and News.