Pudge is a documentation system for Python that generates documentation files from docstrings and uses Restructured Text syntax. You can see a running example in Python Paste. Maybe you could give it a try.
Pudge does look promising. I was able to successfully pull the code from subversion, and after a small patch ;) to setup.py, I was able to install it:
Index: setup.py =================================================================== --- setup.py (revision 134) +++ setup.py (working copy) @@ -1,6 +1,5 @@ # bootstrap setuptools if necessary -from ez_setup import use_setuptools -use_setuptools() +from distutils.core import setup import os import os.path @@ -38,7 +37,6 @@ ('licenses', )]: package_data.extend(get_data_files(os.path.join(*subdir))) -from setuptools import setup setup( name=name,
I wanted to check the archives to see if there had been a discussion about the use of setuptools, but it appears the mailing list, linked from the front page of the project, has gone 404.