httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Joshua Slive" <jos...@slive.ca>
Subject xml module docs
Date Tue, 19 Feb 2002 18:46:00 GMT
If you monitor the CVS list, you have by now noticed that we are converting
the apache module docs (ie, the reference manual part of the docs) to xml.
I just committed for the first time the xslt transformation into cvs.  I did
this to assure that we don't need to maintain two sets of module docs in
2.0.

Now, to edit module docs, first check if there is both an .xml and .html
file.  If there is only .html, then just edit the html as usual.  If there
is an .xml file, then don't edit the .html file, because it is generated
from the .xml.

Instructions on how to deal with the .xml are here:
http://httpd.apache.org/docs-project/docsformat.html

Note that, although the final .xml file will need to be transformed to
.html, you don't need a full transformation setup to edit the docs and check
your works.  Recent versions of MSIE, Mozilla, and Netscape will render the
xml directly with the xsl stylesheet if you request the .xml in your
browser.

Joshua.


Mime
View raw message