From 869723054fa2057ce83f358ca24a27cb7d39d0b6 Mon Sep 17 00:00:00 2001 From: Jirka Kosek Date: Mon, 12 May 2008 07:04:31 +0000 Subject: [PATCH] Updated by feedback --- docbook/relaxng/docbook/howto/TODO | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docbook/relaxng/docbook/howto/TODO b/docbook/relaxng/docbook/howto/TODO index 8ddb95acb..30c00c293 100644 --- 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: + +

+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 
 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  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 
-- 
2.50.1