[Python-Dev] Checked in...

Paul Prescod paul@prescod.net
Mon, 17 Jul 2000 05:42:59 -0500


Ka-Ping Yee wrote:
> 
>...
> 
> My plan was to complete htmldoc.py and try to get in into the
> distribution so that anyone could browse documentation on the
> standard library.  

+1

> It would include an option to start a little
> webserver with a one-line command so that doc pages could be
> automatically generated on your own modules as you work on them.

+0

> The next step in the plan was to provide text output so you
> could ask about modules from the shell prompt (like a "man"
> command specific to Python) and a function call you could use
> from inside the interpreter to get quick help as well.

Not sure how to interpret this. If it depends on the aforementioned web
server, I'm -1. If it calls the htmldoc code directly, I'm +1. I'd love
to have the interpreter build on your docstring-formatting heuristics
and that docstring-language plugin feature we discussed to allow people
to experiment with semi-structured docstring formats.

-- 
 Paul Prescod - Not encumbered by corporate consensus
It's difficult to extract sense from strings, but they're the only
communication coin we can count on. 
	- http://www.cs.yale.edu/~perlis-alan/quotes.html