Quick Reference from module doc strings.

Ron Adam rrr at ronadam.com
Tue May 17 12:10:59 EDT 2005


Michele Simionato wrote:
>>Do you have any feature suggestions, additional information that
> 
> could
> 
>>go in, something that would extend the content in some way and make
> 
> it
> 
>>more useful?
> 
> 
> I have written something similar which I use all the time. It generates
> ReST
> output which I can browse with "less" from the command line, as well as
> HTML
> output and PDF output that I can print. The hard work is done by
> docutils, of course.
> I have options to specify if I want to least private names or not, and
> to specify
> if I want an analytical index to be generated or not. Also, the HTML
> output
> contains hyperlinks to the original source code, so I can see  it with
> a click.
> I can feed to "minidoc" whole packages (it works recursively on
> subpackages, so everything is documented).
> 
> It was unvaluable in my struggle with Zope.
> 
>             Michele Simionato
> 

Hi Michele,

Sound great!  Adding a command line parser, I'm going to add a brief 
command line parser to it today, but nothing as elaborate as you have 
already.  Could you post a part of the output as an example?  How is the 
index built?

The direction I'm going is to build a database/dictionary with each 
individual item as a record. Maybe feed it the whole lib directory, then 
to be able to generate cross module/package lists by subject or keyword. 
  I'm not exactly sure how to connect everything together yet.  This is 
a figure it out as I go project, but I think it's worth trying.

Cheers,
_Ron








More information about the Python-list mailing list