svn commit: r1875856 - /httpd/docs-build/trunk/README

[co...@apache.org]

Author: covener
Date: Sun Mar 29 13:43:40 2020
New Revision: 1875856

URL: http://svn.apache.org/viewvc?rev=1875856&view=rev
Log:
some open issues


Modified:
    httpd/docs-build/trunk/README

Modified: httpd/docs-build/trunk/README
URL: http://svn.apache.org/viewvc/httpd/docs-build/trunk/README?rev=1875856&r1=1875855&r2=1875856&view=diff
==============================================================================
--- httpd/docs-build/trunk/README (original)
+++ httpd/docs-build/trunk/README Sun Mar 29 13:43:40 2020
@@ -1,3 +1,5 @@
+## 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
@@ -15,3 +17,21 @@ 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)
+