Pushed more of the svg doc out of the faq and into svg.xml.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196146 13f79535-47bb-0310-9956-ffa450edef68

2 files changed, 12 insertions, 30 deletions

diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml
index 9fd96ee01..efee6e975 100644
--- a/src/documentation/content/xdocs/faq.xml
+++ b/src/documentation/content/xdocs/faq.xml
@@ -791,35 +791,10 @@ transformer.transform(xmlsource, new SAXResult(driver.getContentHandler()));</so
   <part id="part_svg">
     <title>Batik/SVG specific questions</title>
     <faq id="svg_text">
-      <question>SVG text rendered in bad quality. How do I put SVG text as text
-      into PDF?</question>
+      <question>The rendering of SVG text in my PDF is of poor quality.
+Can I control this?</question>
       <answer>
-        <p>
-          The svg text is rendered as shapes, the Acrobat viewer displays it
-          with bad quality unless you turn on smooth line art in the Acrobat
-          preferences. The printout is always ok, it's only the screen view
-          which is of bad quality by default.
-        </p>
-        <p>
-          You can force Batik not to render SVG text by setting the
-          strokeSVGText property to false. You can do this in the user
-          configuration file:
-        </p>
-        <source><![CDATA[<entry>
-  <key>strokeSVGText</key>
-  <value>false</value>
-</entry>]]></source>
-        <p>
-          In a servlet environment, you can set it directly:
-        </p>
-        <source>org.apache.fop.configuration.Configuration.put("strokeSVGText", Boolean.FALSE);</source>
-        <p>
-          See also <link href="#usercfg">using a user configuration file</link>
-          in a servlet.
-        </p>
-        <p>
-          This does not work for other renderers.
-        </p>
+        <p>See <link href="svg.html#pdf_text">Placing SVG Text into PDF</link>.</p>
       </answer>
     </faq>
     <faq id="svg_headless">
diff --git a/src/documentation/content/xdocs/svg.xml b/src/documentation/content/xdocs/svg.xml
index 87da16b13..78fcd4c2d 100644
--- a/src/documentation/content/xdocs/svg.xml
+++ b/src/documentation/content/xdocs/svg.xml
@@ -94,19 +94,26 @@ for PDF it will use a single character.
     </p>
     <p>
 It is possible to make sure that all text is drawn into PDF using the
-PDF text commands by adding the following to the user config:
+PDF text commands (instead of the graphical shapes), by adding the following to the user config:
     </p>
 <source><![CDATA[<entry>
   <key>strokeSVGText</key>
   <value>false</value>
 </entry>]]></source>
+    <p>In a servlet environment, you can set it directly:</p>
+    <source>org.apache.fop.configuration.Configuration.put("strokeSVGText", Boolean.FALSE);</source>
+    <p>For information on using a configuration file in a servlet, see the <link href="faq.html#usercfg">FAQ</link> on that topic.</p>
+    <p>Note that this configuration setting works only for the PDF renderer.</p>
     <p>
-The drawback from this is that all text will be confined to text that is
+The drawback to forcing text to be rendered as text is that it will be confined to text that is
 possible for PDF fonts (including embedded fonts) and implemented with
 this workaround. The fonts available are the standard pdf fonts and any
 fonts that you have embedded using FOP. The font sizes will be rounded
 to an integer value. In future this will be improved.
     </p>
+    <p>Note that because SVG text can be rendered as either text or a vector graphic, you may need to consider settings in your viewer for both.
+The Acrobat viewer has both "smooth line art" and "smooth text" settings that may need to be set for SVG images to be displayed nicely on your screen (see Edit / Preferences / Display).
+This setting will not affect the printing of your document, which should be OK in any case, but will only affect the quality of the screen display.</p>
   </section>
 
           <section>