## Intro

This repository is checked out into docs/manual/build
of an httpd working tree to support documentation
authoring, and works on all httpd branches from 2.0
through trunk.

To completely rebuild the docs, use:

      ./build.sh all convmap

To check for valid XML:

      ./build.sh validate-xml

To check the resulting HTML:

      ./build.sh validate-xhtml

## Current issues

### build.sh

build.sh sometimes needs to be modified to drop -Xbootclasspath as this parm is gone
from later SDKs. It should probably NOT be dropped for everyone:

 - On IBM Java 6 this probably causes a built-in xalan to be used which does not have our patch
   for splitting the XML and DocType lines.  There could be other more subtle changes.
   - Impact: ???

### UTF-8 vs. XML entities in foo.html.en

Old JDK's happily put UTF-8 bytes into ISO8859-1 english files which seems wrong.
Newer JDK's (w/o -Xbootclasspath? in build.sh?) will replace them with XML entities.

Impact: XML entities break manpages (if checked in)