[Doc-SIG] Automatic docs from .py's - what's the latest word?

Fred L. Drake Fred L. Drake, Jr." <fdrake@acm.org
Wed, 5 May 1999 13:15:23 -0400 (EDT)


Randall Hopper writes:
 >      I checked the FAQ, and it suggests gendoc.  I went to the gendoc page,
 > and it said use pythondoc.  The doc-sig page on Python.org suggests HTMLgen
 > and gendoc, but not pythondoc.
 > 
 >      Guess my basic question is, which of these are being supported and
 > which have been retired.  Also, which do function signature extraction
 > along with grabbing and formatting docstrings?  A flat text file or man
 > page is my desired documentation target.

Randall,
  I'm not sure what the current state of pythondoc is; it's definately 
intended to be a replacement for gendoc.  I do plan to spend a little
time checking it out at some point before too much longer, but some of 
the paying projects need to get done at the moment.  ;-)
  I think Daniel Larsson, the author of both gendoc and pythondoc, has 
been busy with other projects lately and hasn't had time to work on or 
maintain these packages.  Daniel, if you get this, can you give us a
brief update regarding your intentions with further development and
maintenance of these packages?


  -Fred

--
Fred L. Drake, Jr.	     <fdrake@acm.org>
Corporation for National Research Initiatives