Juergen Hermann wrote:

Maybe I'm thick here, but from a more than cursory look at the docs I got the impression that docutils is still "just" a document processor, and that there is no front-end to extract docstrings from source and format them.

Can somebody enlighten me, and shove me in the right direction?

Docstring extraction is still under development (you're not thick, at least not in this instance ;-). I have most of a source code parsing module in docutils/readers/python/moduleparser.py. I haven't worked on it in a while, but I do plan to finish it eventually. Ian Bicking wrote an initial front end for my moduleparser module, in sandbox/ianb/extractor/extractor.py. -- David Goodger http://starship.python.net/~goodger Programmer/sysadmin for hire: http://starship.python.net/~goodger/cv