ANN: PythonDoc 2.0 beta 2 (october 23, 2003)
Fredrik Lundh
fredrik@pythonware.com
Thu, 23 Oct 2003 20:25:53 +0200
PythonDoc is a documentation tool for Python, inspired by JavaDoc.
Like JavaDoc, PythonDoc scans your Python code for doc comments,
and generates API documentation in XML and HTML formats. Python-
Doc supports basic JavaDoc tags like @param and @return, and adds
a few Python-specific tags. You can use PythonDoc comments to
describe module-level variables and constants, functions, classes,
methods, and attributes.
PythonDoc 2.0 is a complete rewrite of my xmltoys/PythonDoc tool
from last year. The new version uses a much improved parser (based
on source code scanning rather than introspection), and is designed
to work with Python 1.5.2 and later.
Brief description and examples (for an earlier alpha release):
http://online.effbot.org/2003_10_01_archive.htm#pythondoc-20a1
Downloads:
http://effbot.org/downloads#pythondoc
http://effbot.org/downloads#elementtree
Documentation:
http://effbot.org/zone/pythondoc.htm
Sample output (using the default "compact HTML" renderer):
http://effbot.org/zone/pythondoc-compact.htm
enjoy /F