Russ, Thanks for the help, but I couldn't find a build.sh. I made a temporary XML -> HTML translation using my browser and the magical "View Selected Souce" feature (I know it's a hack, but it worked for the most part).
I am going to forward my issues to the apache-doc project mailing list (which I found last night). Thanks again for getting me started, Dave On 4/15/07, Russ Allbery <[EMAIL PROTECTED]> wrote:
David Wortham <[EMAIL PROTECTED]> writes: > Hello again developers, > Can anyone reccomend any good module documentation tools? > I'm looking for somthing that generates an HTML file very similar to the > official Apache module docs (see > http://httpd.apache.org/docs/2.0/mod/mod_rewrite.html) You could just use the Apache tools. From the WebAuth documentation: Building Module Documentation The files doc/mod_*.xml have the module documentation for the Apache modules that come with WebAuth, in the XML format that is used for the Apache reference manual. Pre-built copies of the HTML files suitable for dropping into a built Apache 2.x manual directory are also provided for convenience. Whenever the module documentation is changed in the XML files, the HTML files need to be rebuilt. Basic instructions for doing so are at: <http://httpd.apache.org/docs-project/docsformat.html> The basic steps are as follows: svn co \ http://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x/docs/\ apache-docs cd apache-docs/manual svn co http://svn.apache.org/repos/asf/httpd/docs-build/trunk build cd build JAVA_HOME=/usr/lib/j2re1.4-sun # (whatever your java home is) export JAVA_HOME cp /path/to/webauth3/doc/mod_*.xml* ../mod/ ./build.sh Following that procedure (assuming Java doesn't "run out of memory", which occasionally happens to me) should generate: ../mod/mod_web{auth,authldap,kdc}.html.en which can then be copied into the WebAuth tree. Once this infrastructure is set up, regenerating the documentation is only a matter of copying in new *.xml files and ./build.sh will incrementally rebuild only those files. -- Russ Allbery ([EMAIL PROTECTED]) <http://www.eyrie.org/~eagle/>
-- David Wortham Senior Web Applications Developer Unspam Technologies, Inc. 1901 Prospector Dr. #30 Park City, UT 84060 (435) 513-0672
