From f09ec7881f53619870e157ff1ef6efee9c627bd0 Mon Sep 17 00:00:00 2001
From: William Victor Mote <vmote@apache.org>
Date: Mon, 16 Jun 2003 23:00:54 +0000
Subject: [PATCH] Clean up content a bit for Text Renderer. Add comments about
 optimal settings to minimize spacing problems. Contributed by Vincent Illiano
 (see http://marc.theaimsgroup.com/?l=fop-dev&m=104687730831749&w=2).

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196502 13f79535-47bb-0310-9956-ffa450edef68
---
 src/documentation/content/xdocs/output.xml | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/src/documentation/content/xdocs/output.xml b/src/documentation/content/xdocs/output.xml
index 3ba4a509a..16296837b 100644
--- a/src/documentation/content/xdocs/output.xml
+++ b/src/documentation/content/xdocs/output.xml
@@ -277,19 +277,15 @@ Adobe Framemaker. This is currently not fully implemented.
 <section id="txt">
   <title>TXT</title>
     <p>
-Text as you could imagine does not work very well. It is an output format
-that you should expect bad results. The main purpose of this is to get
-a quick and dirty view of the document and the text inside it.
-    </p>
-    <p>
-The TXTRenderer is a FOP renderer that produces plain ASCII text output
+The text renderer produces plain ASCII text output
 that attempts to match the output of the PDFRenderer as closely as
 possible. This was originally developed to accommodate an archive system
-that could only accept plain text files. Of course when limited to plain
-fixed pitch text the output does not always look very good.
+that could only accept plain text files, and is primarily useful for getting
+a quick-and-dirty view of the document text. The renderer is very limited,
+so do not be surprised if it gives unsatisfactory results.
     </p>
     <p>
-The TXTRenderer works with a fixed size page buffer. The size of this
+The Text renderer works with a fixed size page buffer. The size of this
 buffer is controlled with the textCPI and textLPI public variables.
 The textCPI is the effective horizontal characters per inch to use.
 The textLPI is the vertical lines per inch to use. From these values
@@ -298,6 +294,13 @@ The formatting objects to be rendered are then mapped to this grid.
 Graphic elements (lines, borders, etc) are assigned a lower priority
 than text, so text will overwrite any graphic element representations.
     </p>
+    <p>Because FOP lays the text onto a grid during layout, there are frequently extra or missing spaces between characters and lines, which is generally unsatisfactory.
+Users have reported that the optimal settings to avoid such spacing problems are:</p>
+    <ul>
+      <li>font-family="Courier"</li>
+      <li>font-size="7.3pt"</li>
+      <li>line-height="10.5pt"</li>
+    </ul>
 </section>
 
     </body>
-- 
2.39.5