Epydoc

If you're looking for a tool that generates API documentation for Python modules, then Epydoc could be a great solution. The software operates by analyzing the docstrings of your modules, and then formatting the information into documentation. A handy feature of Epydoc is its ability to use a lightweight markup language called epytext. This language can help to format docstrings, add information about specific fields, and make the output easier to read.

Epydoc is also versatile in terms of the types of docstrings it can detect. It understands docstrings written in reStructuredText, Javadoc, and plaintext, among others. For a more extensive example of the output of Epydoc, check out the API documentation for Python 2.4.

There are some requirements for running Epydoc, including a Python 2.4 environment. However, if you meet the requirements, then you'll find that Epydoc is a valuable tool for generating API documentation. In fact, the latest version of Epydoc has even more functionality than before. Specifically, the software can now use both introspection and source code parsing to extract documentation information. By combining information from both sources, Epydoc is able to generate even more comprehensive documentation than before.