Epydoc is a tool for generating API documentation for Python modules, based on their docstrings. <http://epydoc.sourceforge.net/> For some examples of the documentation generated by epydoc, see: - The API documentation for epydoc. (HTML) <http://epydoc.sourceforge.net/api/> - The API documentation for epydoc. (PDF) <http://epydoc.sourceforge.net/epydoc.pdf> - The API documentation for the Python 2.2 standard library. <http://epydoc.sourceforge.net/stdlib/> - The API documentation for NLTK, the natural langauge toolkit. <http://nltk.sourceforge.net/ref/> - The API documentation for Docutils <http://epydoc.sourceforge.net/docutils/> Epydoc currently understands four markup languages: - Epytext, a lightweight markup language with support for basic formatting constructs. - ReStructuredText, an "easy-to-read, what-you-see-is-what-you-get plaintext markup syntax." - Javadoc, the standard markup language for documenting java source. - Plaintext. New features added since 1.1 include: Improvements to Docstring processing ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Support for ReStructuredText docstrings. - Support for Javadoc docstrings. - Many new documentation fields for docstrings. - More robust crossreference link resolving. Improvements to Output Generation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - New output formats: LaTeX, DVI, PostScript, and PDF. - Three new formats for displaying inherited methods and variables: listed, grouped, and included. Improvements to Inspection ~~~~~~~~~~~~~~~~~~~~~~~~~~ - Support for new Python 2.2+ objects, including class methods, static methods, properties, and metaclasses. - Automatic detection of imported variables. - Documentation inheritance for inherited methods and variables. Improvements to Efficiency ~~~~~~~~~~~~~~~~~~~~~~~~~~ - Epydoc 2.0 runs 50%-200% faster than epydoc 1.1. (e.g., it runs 2.6 times as fast when documenting the Python standard library). A complete list of new features and the change log are available at: <http://sourceforge.net/project/shownotes.php?release_id=173036>