CPAN functionality for python - requirements

[Doug Hellmann]

In article <mailman.983305271.1946.python-list at python.org>, "Sean
Reifschneider" <jafo at tummy.com> wrote:

> On Tue, Feb 27, 2001 at 02:49:40AM -0700, Bruce Sass wrote:
> 
>>Huh, there are tools and standards. Isn't /usr/shar/doc/package the FHS
>>place for general package specific
> 
> Where are the tools for turning doc-strings into HTML, and how are the

http://happydoc.sourceforge.net

> links between doc packages handled? 

Hrm, not sure about that one.  HappyDoc can write output to a
subdirectory inside where the source code is...

> What is the markup format for the
> doc strings?

StructuredText.

> We spent quite a while discussing the sad state of the documentation at
> our last pythoneers meeting.  Mark Lutz was shocked that people would
> actually use javadoc, but they do seem to simply becuase it was
> available and was
> "good enough".
> 
> We are missing similar functionality.

Working on it...

Doug