From edloper at gradient.cis.upenn.edu  Tue Feb 27 08:37:47 2007
From: edloper at gradient.cis.upenn.edu (Edward Loper)
Date: Tue, 27 Feb 2007 02:37:47 -0500
Subject: [Doc-SIG] Epydoc 3.0 beta release
Message-ID: <0907700F-8391-4AA8-9217-527C84BC74F8@gradient.cis.upenn.edu>

Epydoc 3.0 beta is now available for download from SourceForge.
Epydoc is a tool for generating API documentation for Python modules,
based on their docstrings.

   - The epydoc homepage.
     <http://epydoc.sourceforge.net/>

   - Download epydoc 3.0 beta.
     <http://sourceforge.net/project/platformdownload.php? 
group_id=32455>

For some examples of the documentation generated by epydoc, see:

   - The API documentation for epydoc.
     <http://epydoc.sourceforge.net/api/>

   - The API documentation for the Python 2.5 standard library.
     <http://epydoc.sourceforge.net/stdlib/>

   - The API documentation for NLTK, the natural language toolkit.
     <http://nltk.sourceforge.net/lite/doc/api/>

The most significant change since Epydoc 2.1 has to do with the way
that epydoc extracts documentation information about python modules.
In previous versions, epydoc extracted information about each module
by importing it, and using introspection to examine its contents.  The
new version of epydoc still supports introspection, but is also
capable of extracting information about python modules by parsing
their source code.  Furthermore, the new version of epydoc can combine
these two sources of information (introspection & parsing).  This is
important because each source has its own advantages and disadvantages
with respect to the other.  For information about the new features in
epydoc 3.0, see the "What's New" page:

     <http://epydoc.sourceforge.net/whatsnew.html>

If you find any bugs, or have suggestions for improving epydoc, please
report them on sourceforge:

   - Bugs: <http://tinyurl.com/odvfw>
   - Features: <http://tinyurl.com/p2rl8>

Or send email to <epydoc-devel at lists.sourceforge.net>.