[PYTHON DOC-SIG] Who is hacking?
Daniel Larsson
dlarsson@sw.seisy.abb.se
Wed, 29 Jan 1997 23:09:12 +0100
------------79A0463356543
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=us-ascii
Mark Hammond wrote:
>
> 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?
I have done most of the implementation, with Robin being the main user
so far
(as far as I know) sending me bug fixes every so often.
> 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 :-)
Hmm, well, not really. I made a simple test case, which I think is
distributed
with the package. If you make enhancements, I'll be more than happy to
incorporate
them into my source and future releases of gendoc.
> My main focusses at the moment are:
> * Make it generate a hierarchical index for an "ni" package (my
> previous hacks generates a "flat" index.
Excellent!
> * 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.
Sounds great!
------------79A0463356543
Content-Transfer-Encoding: 7bit
Content-Type: text/html; charset=us-ascii
<HTML><BODY>
<DT>Mark Hammond wrote:<BR>
> <BR>
> What is the current development status of "gendoc" at the
moment?<BR>
> <BR>
> I take it Robin and Daniel are the main keepers - does this<BR>
> responsibility divide somewhere?<BR>
<BR></DT>
<DT>I have done most of the implementation, with Robin being the main user
so far</DT>
<DT>(as far as I know) sending me bug fixes every so often.</DT>
<DT><BR>
> Are there any good test cases (even private ones people use<BR>
> themselves). If I get brave and start trying to enhance, will
people<BR>
> actually pick up the patches, and make sure they still work as<BR>
> originally intended :-)<BR>
<BR></DT>
<DT>Hmm, well, not really. I made a simple test case, which I think is
distributed</DT>
<DT>with the package. If you make enhancements, I'll be more than happy
to incorporate</DT>
<DT>them into my source and future releases of gendoc.</DT>
<DT><BR>
> My main focusses at the moment are:<BR>
> * Make it generate a hierarchical index for an "ni" package
(my<BR>
> previous hacks generates a "flat" index.</DT>
<DT> </DT>
<DT>Excellent!</DT>
<DT><BR>
> * Make it parse my already marked-up C++ comments, so I can build
a<BR>
> single manual. This should be pretty easy - they are pretty<BR>
> structured, and made more for parsing than reading.<BR>
> * Make my "html2word" tool build good help files from it
(it<BR>
> currently does a "reasonable" job!)<BR>
> <BR>
> After doing all that, we'll have a system which can generate a single<BR>
> set of documentation from both .py and .c(pp) sources, and generate<BR>
<BR>
> it in any of the native gendoc formats, and WinHelp.<BR>
> <BR>
> I reckon that'd be pretty cool :-)<BR>
> <BR>
> Mark.<BR>
<BR></DT>
<DT>Sounds great!</DT>
<DT> </DT>
</BODY>
</HTML>
------------79A0463356543--
_______________
DOC-SIG - SIG for the Python Documentation Project
send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
_______________