[PYTHON DOC-SIG] Who is hacking?

Mark Hammond MHammond@skippinet.com.au
Thu, 30 Jan 1997 08:52:14 +1000

What is the current development status of "gendoc" at the moment?

I take it Robin and Daniel are the main keepers - does this 
responsibility divide somewhere?

Are there any good test cases (even private ones people use 
themselves).  If I get brave and start trying to enhance, will people 
actually pick up the patches, and make sure they still work as 
originally intended :-)

My main focusses at the moment are:
* Make it generate a hierarchical index for an "ni" package (my 
previous hacks generates a "flat" index.
* Make it parse my already marked-up C++ comments, so I can build a 
single manual.  This should be pretty easy - they are pretty 
structured, and made more for parsing than reading.
* Make my "html2word" tool build good help files from it (it 
currently does a "reasonable" job!)

After doing all that, we'll have a system which can generate a single 
set of documentation from both .py and .c(pp) sources, and generate 
it in any of the native gendoc formats, and WinHelp.

I reckon that'd be pretty cool :-)

Mark Hammond - MHammond@skippinet.com.au 
Check out Python - _the_ language for the Web/CGI/Windows/MFC/Unix/etc
<http://www.python.org> & <http://www.python.org/ftp/python/pythonwin>

DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org