Uses of docutils

[Colin J. Williams]

Guillermo wrote:
> Hi,
> 
> I've been playing with docutils in order to use ReStructedText with
> Django, but I was wondering if apart from converting files to html it
> adds anything to Python's self-documenting facilities.
> 
> For instance, the instructions tell you to run "buildhtml.py .." after
> the installation, which generates html files for every txt in the
> passed-in directory and subdirectories.
> 
> What's so good about having a bunch of html scattered in several
> directories? Is there any way in Python to make use of them via the
> interpreter? Should one rather copy them to a separate folder for
> reference?
> 
> Regards,
> 
> Guillermo

I believe epydoc is intended to render 
ReStruct text.

It provides: __docformat__ = 
"restructuredtext en"

Older versions of epydoc provide neat 
documentation - I haven't used the 
latest version.

Colin W.