httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: Potential Docs project
Date Sun, 10 Sep 2000 19:39:26 GMT
rbb@covalent.net wrote:
> 
> I wanted to give a potential project to anybody on this list looking for
> something to help with.  :-)  I would do this myself, but I have very
> poor HTML skills, and my documentation skills aren't great either.  :-)
> 
> Earlier this year, I spent a long time documenting the entire 2.0
> API.  This has been done using ScanDoc, which is a tool to extract docs
> from C files.  Basically, in all of the header files, we have comment
> blocks that look like:
> 
> /**
>  * ...
>  */
> 
> These are ScanDoc blocks.  They way ScanDoc works is that there is a
> template perl script, that is filled out to actually generate the HTML
> files.  It would be really cool if we could make the template file a bit
> cleaner or if it was modified to use DocBook instead of HTML.
> 
> If anybody is interested in working on this with me, please let me know.

Indeed, I would be glad to take this on. Although it sounds like a large
task, and I am sure that we could spread the pain around.

Rich

Mime
View raw message