Re: [Docutils-users] sphinx

[David C. <da...@ar...>]

Alan G Isaac wrote:
>
> Can you please compare with epydoc?
>   

One of the main difference is that sphinx is geared toward separate doc, 
and epydoc does API documentation (from the docstring). It looks like 
Sphinx has added some way to add documentation from docstring recently:

http://sphinx.pocoo.org/ext/autodoc.html

I don't know how it works, I have not used it yet, but I intend to try 
it with numpy really soon ;) (I personally don't like epydoc's output, 
and I don't want to spend time on better output).

cheers,

David