On Tuesday 25 March 2008 07:07:33 pm Gael Varoquaux wrote: > On Tue, Mar 25, 2008 at 06:04:41PM -0500, bryce hendrix wrote: > > How stable is the API? We (Enthought) use endo, a custom tool build on > > top of docutils, to generate our docs currently. We have talked about > > changing tools in the past, but the need to extend the tools to > > understand Traits has held us back. > > Sphinx is not automated API documentation, like Endo or Epidoc. It is for > manual writing of documentation. It does not compete with Endo or Epidoc, > but complements them by taking a set of rst files and compiling both a > set of searchable web pages, and an indexed pdf for print.
Well, I have read that elsewhere, maybe even on the sphinx website, but you actually can use it to document the API. I haven't done a complete comparison of epydoc and sphinx's autodoc extension, but their output seems pretty comparable. Darren ------------------------------------------------------------------------- This SF.net email is sponsored by: Microsoft Defy all challenges. Microsoft(R) Visual Studio 2008. http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/ _______________________________________________ Matplotlib-devel mailing list Matplotlib-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
