Minor changes to the FAQ

Change 0.94 to 0.95 in links
Adapt Opinion about 1.0 release data
Mentioned support for keep-* in recent FOP releases
Fixed FIXME in last Q regarding alternative XML/XSLT stuff
Some minor changes related to 0,94 vs. 0,95 release in some places
Additional minor formatting changes to the XML source

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

1 files changed, 50 insertions, 41 deletions

diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml
index 1838a416a..e34725af3 100644
--- a/src/documentation/content/xdocs/faq.xml
+++ b/src/documentation/content/xdocs/faq.xml
@@ -138,8 +138,10 @@
         <p>
           When it's ready and the committers have enough time to go through 
           the time-consuming process of creating a release. We
-          released version 0.94 on 24th August 2007, and intend to
-          release version 1.0 later in late 2007 or early 2008. If you
+          released version 0.95 on August 6th, 2008, and intend to
+          release version 1.0 once we consider it "feature complete", major
+          work is still in progress regarding page flows with changing page width
+          (changing IPD, to be precise). If you
           want to speed up the process, consider
           <link href="dev/index.html#involved">contributing</link> to FOP.</p>
       </answer>
@@ -211,7 +213,7 @@
           If you run FOP embedded in your servlet, web application or
           other Java application, check the classpath of the
           application. Check the also the information pertaining to <link
-          href="0.94/servlets.html#servlet-engine">servlet engines</link>
+          href="0.95/servlets.html#servlet-engine">servlet engines</link>
           for further hints.
         </p>
         <p>
@@ -241,7 +243,7 @@
       <question>I get an OutOfMemoryException.</question>
       <answer>
         <p>
-          See <link href="0.94/running.html#memory">FOP Memory</link>.
+          See <link href="0.95/running.html#memory">FOP Memory</link>.
         </p>
       </answer>
     </faq>
@@ -302,7 +304,7 @@
         <p>
           If you use XSLT, problems in your style sheet and in your
           source XML also can produce a NullPointerException. <link
-          href="0.94/running.html#check-input">Run the transformation
+          href="0.95/running.html#check-input">Run the transformation
           separately</link> to check for this, usually you'll get a
           detailed error message from the XSLT processor.
         </p>
@@ -380,7 +382,7 @@
         </p>
         <p>
           Try also setting the <link
-          href="0.94/configuration.html#general-elements">font-base
+          href="0.95/configuration.html#general-elements">font-base
           configuration</link>.
         </p>
       </answer>
@@ -439,12 +441,11 @@ public class DefaultErrorListener implements ErrorListener {
           So this failure doesn't break anything.
         </p>
         <p>
-           To avoid the warning you can simply delete the
-           old Font Cache file, which according to [1] lives in ${base}\conf\font.cache.
-           Or you can disable Font Caching altogether using the option "use-cache"
-        </p>
-        <p>
-          [1] http://xmlgraphics.apache.org/fop/0.94/configuration.html#general-elements
+          To avoid the warning you can simply delete the
+          old Font Cache file, which lives in ${base}\conf\font.cache (see <link
+          href="0.95/configuration.html#general-elements">font-base
+          configuration</link>). Or you can disable Font Caching altogether using
+          the option "use-cache."
         </p>
       </answer>
     </faq>
@@ -452,7 +453,7 @@ public class DefaultErrorListener implements ErrorListener {
   <part id="part-output">
     <title>Problems with FOP output</title>
     <faq id="leader-expansion">
-      <question>Leaders don't work anymore in 0.94. Instead of
+      <question>Leaders don't work anymore in 0.94 or later. Instead of
       filling the line, only three dots or a short ruler is
       output.</question>
       <answer>
@@ -533,7 +534,7 @@ Check the following:</p>
         <p>Other possibilities:</p>
         <ul>
           <li>The image format is not supported or not supported completely.
-          See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
+          See <link href="0.95/graphics.html">FOP Graphics Formats</link> for a
           list of supported formats and related issues.</li>
           <li>The graphic may be too large to fit into the intended space.</li>
           <li>There may be something (static content) that is obscuring the
@@ -545,14 +546,14 @@ Check the following:</p>
     <faq id="png-fails">
       <question>My graphical images do not work properly.</question>
       <answer>
-        <p>See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
+        <p>See <link href="0.95/graphics.html">FOP Graphics Formats</link> for a
         list of supported graphics formats and related issues.</p>
       </answer>
     </faq>
     <faq id="graphic-resolution">
       <question>Why is my graphic rendered at a different resolution than it was created?</question>
       <answer>
-        <p>See <link href="0.94/graphics.html#resolution">Graphics Resolution</link>.</p>
+        <p>See <link href="0.95/graphics.html#resolution">Graphics Resolution</link>.</p>
       </answer>
     </faq>
     <faq id="keep-with">
@@ -560,8 +561,14 @@ Check the following:</p>
       don't work.</question>
       <answer>
         <p>
-          These properties are not implemented on version 0.20.5 and earlier, except on table rows. In
-          order to take advantage of them, you have to nest stuff to be
+          These properties are not implemented on version 0.20.5 and earlier,
+          except on table rows. More recent FOP releases have extensive support for
+          these properties. The current release, FOP 0.95, still supports the
+          values "always" and "never" only, no numerical values. There may be
+          a few places where keep-* still don't work, this should be very rare.
+        </p>
+        <p>
+          If you still have to use FOP 0.20.5, you have to nest stuff to be
           kept together in a table.
         </p>
         <p>
@@ -705,7 +712,7 @@ Check the following:</p>
       <answer>
         <p>Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):</p>
         <source><![CDATA[<fo:page-sequence language="fi">]]></source>
-        <p>See <link href="0.94/hyphenation.html#support">Hyphenation Support</link> for details and instructions on using hyphenation with FOP.</p>
+        <p>See <link href="0.95/hyphenation.html#support">Hyphenation Support</link> for details and instructions on using hyphenation with FOP.</p>
         <p>Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):</p>
         <source><![CDATA[<fo:block hyphenate="true">]]></source>
       </answer>
@@ -751,7 +758,7 @@ Check the following:</p>
       <question>How do I use FOP in a servlet?</question>
       <answer>
         <p>
-          See <link href="0.94/servlets.html">Using FOP in a Servlet</link>.
+          See <link href="0.95/servlets.html">Using FOP in a Servlet</link>.
         </p>
       </answer>
     </faq>
@@ -760,7 +767,7 @@ Check the following:</p>
       transformation?</question>
       <answer>
         <p>
-          See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
+          See <link href="0.95/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
         </p>
       </answer>
     </faq>
@@ -768,7 +775,7 @@ Check the following:</p>
       <question>How do I pass parameters to the XSLT transformation?</question>
       <answer>
         <p>
-          See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
+          See <link href="0.95/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
         </p>
       </answer>
     </faq>
@@ -786,7 +793,7 @@ Check the following:</p>
       <question>How do I set the baseDir property in a servlet environment?</question>
       <answer>
         <p>
-          See <link href="0.94/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
+          See <link href="0.95/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
         </p>
       </answer>
     </faq>
@@ -794,7 +801,7 @@ Check the following:</p>
       <question>How do I use a user configuration file from a servlet?</question>
       <answer>
         <p>
-          See <link href="0.94/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
+          See <link href="0.95/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
         </p>
       </answer>
     </faq>
@@ -803,7 +810,7 @@ Check the following:</p>
         get FOP working for various servlet engines?</question>
       <answer>
         <p>
-          See <link href="0.94/servlets.html#servlet-engine">Servlet Engines</link>.
+          See <link href="0.95/servlets.html#servlet-engine">Servlet Engines</link>.
         </p>
       </answer>
     </faq>
@@ -811,7 +818,7 @@ Check the following:</p>
       <question>Can FOP be used in multithreaded environments?</question>
       <answer>
         <p>
-          See <link href="0.94/embedding.html#multithreading">Multithreading FOP</link>.
+          See <link href="0.95/embedding.html#multithreading">Multithreading FOP</link>.
         </p>
       </answer>
     </faq>
@@ -822,13 +829,13 @@ Check the following:</p>
       <question>The rendering of SVG text in my PDF is of poor quality.
 Can I control this?</question>
       <answer>
-        <p>See <link href="0.94/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
+        <p>See <link href="0.95/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
       </answer>
     </faq>
     <faq id="svg-headless">
       <question>How do I use FOP with SVG on headless servers?</question>
       <answer>
-        <p>See <link href="0.94/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
+        <p>See <link href="0.95/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
       </answer>
     </faq>
     <faq id="svghangs">
@@ -891,7 +898,7 @@ Can I control this?</question>
     <faq id="svg-scaling">
       <question>Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?</question>
       <answer>
-        <p>See <link href="0.94/graphics.html#svg-scaling">SVG Scaling</link>.</p>
+        <p>See <link href="0.95/graphics.html#svg-scaling">SVG Scaling</link>.</p>
       </answer>
     </faq>
     <faq id="svg-attribute-required">
@@ -924,7 +931,7 @@ Can I control this?</question>
       <question>How do I embed fonts in PDF?</question>
       <answer>
         <p>
-          See the <link href="0.94/fonts.html">Fonts</link> page for information
+          See the <link href="0.95/fonts.html">Fonts</link> page for information
           about embedding fonts.
         </p>
       </answer>
@@ -943,7 +950,7 @@ Can I control this?</question>
           set. For a variety of reasons, even those are not completely
           guaranteed to work, for example you can't use the fi
           ligature from the standard serif font. Check the <link
-          href="0.94/output.html#pdf-fonts">overview</link> for the default
+          href="0.95/output.html#pdf-fonts">overview</link> for the default
           PDF fonts.
         </p>
         <p>
@@ -951,7 +958,7 @@ Can I control this?</question>
           the desired character. Furthermore the font must be
           available on the machine where the PDF is viewed or it must
           have been embedded in the PDF file. See <link
-          href="0.94/fonts.html">embedding fonts</link>.
+          href="0.95/fonts.html">embedding fonts</link>.
         </p>
         <p>
           For most symbols, it is better to select the symbol font
@@ -969,7 +976,7 @@ Can I control this?</question>
     <faq id="pdf-postprocess">
       <question>What tools are available for post-processing my PDF document?</question>
       <answer>
-        <p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
+        <p>See <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
       </answer>
     </faq>
     <faq id="pdf-security">
@@ -977,8 +984,8 @@ Can I control this?</question>
       to my PDF document?</question>
       <answer>
         <p>
-          See <link href="0.94/pdfencryption.html">PDF Encryption</link>.
-          See also <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.
+          See <link href="0.95/pdfencryption.html">PDF Encryption</link>.
+          See also <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.
         </p>
       </answer>
     </faq>
@@ -986,13 +993,13 @@ Can I control this?</question>
       <question>How do I add document properties (title, author, etc.) to my
       PDF document?</question>
       <answer>
-        <p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
+        <p>See <link href="0.95/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
       </answer>
     </faq>
     <faq id="pdf-watermark">
       <question>How do I add watermarks to my PDF document?</question>
       <answer>
-        <p>See <link href="0.94/output.html#pdf-watermark">PDF Watermarks</link>.</p>
+        <p>See <link href="0.95/output.html#pdf-watermark">PDF Watermarks</link>.</p>
       </answer>
     </faq>
     <faq id="pdf-print-contortion">
@@ -1028,7 +1035,7 @@ Can I control this?</question>
       <answer>
         <p>
           This is a problem of Internet Explorer requesting the content several
-          times. Please see the <link href="0.94/servlets.html#ie">notes on Internet Explorer</link>
+          times. Please see the <link href="0.95/servlets.html#ie">notes on Internet Explorer</link>
           for more information.
         </p>
       </answer>
@@ -1315,8 +1322,10 @@ Can I control this?</question>
             bugs and processor specific APIs. Note that JDK 1.4 comes with an
             XML parser and an XSLT processor which are older versions of
             Xerces and Xalan, respectively, and both have a number of annoying
-            bugs. See $$$FIXME on how to use more recent versions or other
-            packages instead.
+            bugs. See http://java.sun.com/developer/EJTechTips/2003/tt0311.html
+            and http://java.sun.com/j2se/1.4.2/docs/guide/standards/ (or similar
+            pages for later Java releases) for some hints on how to use more
+            recent versions or other packages instead.
           </li>
           <li>
             Problems with servlet containers should be asked on the vendor
@@ -1325,7 +1334,7 @@ Can I control this?</question>
           <li>
             More general questions regarding Java, including deployment, Java
             APIs, classpath issues and property definitions should be redirected
-            to some Java specific list.
+            to an appropriate Java specific list.
           </li>
         </ul>
       </answer>