I moved to docutils.
The only lack, thus far (imho), is syntax highlighting.
So I've written a small python script to parse the text,
and automatically highlight any python-esque code
Should I include this in the next version, post online, or what?
Or should I send this over to the docutils people?
Ugh. Doing the highlighting myself was a mess. So I used that wonderful world of ASPN recipes and SilverCity instead (Thanks to Marek for the heads up. In fact, pointing those out was 90% of the work).
I included the scripts in the documentation directory.
For all who'd like to create the docs by themselves, I made a SilverCity binary: http://www.pythonwiki.de/PythonErweiterungen/WindowsBinaries
How about the docs online on drpython.sourceforge.net, just like the PSF does?