On 10/5/06, Dmitry Vasiliev <[EMAIL PROTECTED]> wrote:
What do you think about to use an API documentation tool, epydoc
(http://epydoc.sourceforge.net/) for example? Unfortunately I haven't used it
myself yet, but the examples looks promising (for example:

I've played with Epydoc 2 a little; it's nice, but as Jim noted, the
markup can be a little heavy.

Early versions of Epydoc 3 have been released, which should solve some
of the problems by supporting docstrings for variables directly rather
than requiring they be embedded in module and class docstrings.  I
think there's supposed to be some support for interfaces as well,
which, potentially, would be enormously helpful for any Zope-related

I've not had a chance to play with the new version, though, so can't
speak from experience on that.


Fred L. Drake, Jr.    <fdrake at gmail.com>
"Every sin is the result of a collaboration." --Lucius Annaeus Seneca
For more information about ZODB, see the ZODB Wiki:

ZODB-Dev mailing list  -  ZODB-Dev@zope.org

Reply via email to