Updated by feedback

diff --git a/docbook/relaxng/docbook/howto/TODO b/docbook/relaxng/docbook/howto/TODO
index 8ddb95acb5ce8e99cb96e1e9c696e6a84cba1ca7..30c00c2932c8b4c9397a25d6e5e0cfe41a47301a 100644 (file)
--- a/docbook/relaxng/docbook/howto/TODO
+++ b/docbook/relaxng/docbook/howto/TODO
@@ -27,3 +27,22 @@ Tom
   
 ...and to other existing DB5 customizations
 * DONE Add more references (NVDL, ...)
+
+* TODO Improve breaking of long lines
+Gentlemen,
+
+  I am trying to read the subject guide via html and find it most difficult because of the formatting.   The problem is that the display is much too wide and causes horizontal scrolling.  This is because the contents of the line:
+
+<pre class="screen"><span class="command"><strong>
+java -Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeParserConfiguration -jar /path/to/oNVDL/bin/onvdl.jar /path/to/docbook.nvdl document.xml
+...
+
+are all on one line (182 characters!) and the browser does not wrap <pre> constructs.  The problem of excessive line length also exists in the pdf version of the book.
+
+At the Linux From Scratch project we have been using DocBook for several years and have found the best practice to be to limit any <screen> elements to 76 characters or less.  This may not be possible in your case as the define is quite long, but how about breaking at before the -jar portion of the line?
+
+
+Thanks for your attention.
+
+  -- Bruce Dubbs
+     Editor, Linux From Scratch