On Tue, Feb 7, 2012 at 4:11 AM, Florian Weimer <f...@deneb.enyo.de> wrote: > I'm slightly confused about docstrings and HTML documentation. I used > to think that the library reference was (in part) generated from the > source code, but this does not seem to be the case. > > Is there any tool support for keeping documentation and code in sync?
Yes. Sphinx's "autodoc" extension allows the placement of API documentation directly in docstrings and comments: http://sphinx.pocoo.org/ext/autodoc.html Cheers, Chris -- http://mail.python.org/mailman/listinfo/python-list
