From fe382482792688fecdff6bc3e3a674035281637c Mon Sep 17 00:00:00 2001 From: Joerg Pietschmann Date: Fri, 6 Nov 2009 23:47:50 +0000 Subject: [PATCH] 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 --- src/documentation/content/xdocs/faq.xml | 91 ++++++++++++++----------- 1 file 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 @@

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 contributing to FOP.

@@ -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 servlet engines + href="0.95/servlets.html#servlet-engine">servlet engines for further hints.

@@ -241,7 +243,7 @@ I get an OutOfMemoryException.

- See FOP Memory. + See FOP Memory.

@@ -302,7 +304,7 @@

If you use XSLT, problems in your style sheet and in your source XML also can produce a NullPointerException. Run the transformation + href="0.95/running.html#check-input">Run the transformation separately to check for this, usually you'll get a detailed error message from the XSLT processor.

@@ -380,7 +382,7 @@

Try also setting the font-base + href="0.95/configuration.html#general-elements">font-base configuration.

@@ -439,12 +441,11 @@ public class DefaultErrorListener implements ErrorListener { So this failure doesn't break anything.

- 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" -

-

- [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 font-base + configuration). Or you can disable Font Caching altogether using + the option "use-cache."

@@ -452,7 +453,7 @@ public class DefaultErrorListener implements ErrorListener { Problems with FOP output - Leaders don't work anymore in 0.94. Instead of + Leaders don't work anymore in 0.94 or later. Instead of filling the line, only three dots or a short ruler is output. @@ -533,7 +534,7 @@ Check the following:

Other possibilities:

  • The image format is not supported or not supported completely. - See FOP Graphics Formats for a + See FOP Graphics Formats for a list of supported formats and related issues.
  • The graphic may be too large to fit into the intended space.
  • There may be something (static content) that is obscuring the @@ -545,14 +546,14 @@ Check the following:

    My graphical images do not work properly. -

    See FOP Graphics Formats for a +

    See FOP Graphics Formats for a list of supported graphics formats and related issues.

         Why is my graphic rendered at a different resolution than it was created? -

    See Graphics Resolution.

    +

    See Graphics Resolution.

         @@ -560,8 +561,14 @@ Check the following:

    don't work.

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

    +

    + If you still have to use FOP 0.20.5, you have to nest stuff to be kept together in a table.

    @@ -705,7 +712,7 @@ Check the following:

    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):

    ]]> -

    See Hyphenation Support for details and instructions on using hyphenation with FOP.

    +

    See Hyphenation Support for details and instructions on using hyphenation with FOP.

    Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):

    ]]>     @@ -751,7 +758,7 @@ Check the following:

    How do I use FOP in a servlet?

    - See Using FOP in a Servlet. + See Using FOP in a Servlet.

    @@ -760,7 +767,7 @@ Check the following:

    transformation?

    - See Using FOP in a Servlet with XSLT Transformation. + See Using FOP in a Servlet with XSLT Transformation.

    @@ -768,7 +775,7 @@ Check the following:

    How do I pass parameters to the XSLT transformation?

    - See Using FOP in a Servlet with XSLT Transformation. + See Using FOP in a Servlet with XSLT Transformation.

    @@ -786,7 +793,7 @@ Check the following:

    How do I set the baseDir property in a servlet environment?

    - See Setting the Configuration Programmatically. + See Setting the Configuration Programmatically.

    @@ -794,7 +801,7 @@ Check the following:

    How do I use a user configuration file from a servlet?

    - See Using a Configuration File in an Embedded App. + See Using a Configuration File in an Embedded App.

    @@ -803,7 +810,7 @@ Check the following:

    get FOP working for various servlet engines?

    - See Servlet Engines. + See Servlet Engines.

    @@ -811,7 +818,7 @@ Check the following:

    Can FOP be used in multithreaded environments?

    - See Multithreading FOP. + See Multithreading FOP.

    @@ -822,13 +829,13 @@ Check the following:

    The rendering of SVG text in my PDF is of poor quality. Can I control this? -

    See Placing SVG Text into PDF.

    +

    See Placing SVG Text into PDF.

     How do I use FOP with SVG on headless servers? -

    See FOP: Graphics (Batik).

    +

    See FOP: Graphics (Batik).

         @@ -891,7 +898,7 @@ Can I control this? Why is my SVG rendered at a size different from that specified in my fo:external-graphic element? -

    See SVG Scaling.

    +

    See SVG Scaling.

         @@ -924,7 +931,7 @@ Can I control this? How do I embed fonts in PDF?

    - See the Fonts page for information + See the Fonts page for information about embedding fonts.

    @@ -943,7 +950,7 @@ Can I control this? 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 overview for the default + href="0.95/output.html#pdf-fonts">overview for the default PDF fonts.

    @@ -951,7 +958,7 @@ Can I control this? 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 embedding fonts. + href="0.95/fonts.html">embedding fonts.

    For most symbols, it is better to select the symbol font @@ -969,7 +976,7 @@ Can I control this? What tools are available for post-processing my PDF document? -

    See PDF Post-processing.

    +

    See PDF Post-processing.

     @@ -977,8 +984,8 @@ Can I control this? to my PDF document?

    - See PDF Encryption. - See also PDF Post-processing. + See PDF Encryption. + See also PDF Post-processing.

    @@ -986,13 +993,13 @@ Can I control this? How do I add document properties (title, author, etc.) to my PDF document? -

    See PDF Post-processing.

    +

    See PDF Post-processing.

         How do I add watermarks to my PDF document? -

    See PDF Watermarks.

    +

    See PDF Watermarks.

         @@ -1028,7 +1035,7 @@ Can I control this?

    This is a problem of Internet Explorer requesting the content several - times. Please see the notes on Internet Explorer + times. Please see the notes on Internet Explorer for more information.

    @@ -1315,8 +1322,10 @@ Can I control this? 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.
  • Problems with servlet containers should be asked on the vendor @@ -1325,7 +1334,7 @@ Can I control this?
  • 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.
-- 2.39.5