xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From je...@apache.org
Subject cvs commit: xml-site/targets/fop/dev compiling.html download.html tools.html tools.pdf configuration.html examples.html extensions.html faq.html faq.pdf fonts.html index.html svg.html
Date Tue, 25 Mar 2003 02:34:14 GMT
jefft       2003/03/24 18:34:13

  Modified:    targets/fop faq.html faq.pdf implemented.html
                        implemented.pdf relnotes.html relnotes.pdf
               targets/fop/design architecture.html architecture.pdf
                        areas.html breakpos.html embedding.html
                        extending.html fotree.html index.html layout.html
                        optimise.html properties.html renderers.html
                        useragent.html
               targets/fop/design/alt.design FOPropertySets.html
                        FoXMLEvent.html SyncedFoXmlEventsBuffer.html
                        XMLNamespaces.html codedisplay.js
               targets/fop/design/alt.design/properties
                        AbstractPropertyValue.html FOAttributes.html
                        PropNames.html Property.html PropertyConsts.html
                        PropertyParser.html PropertySets.html
                        PropertyTokenizer.html PropertyValue.html
                        PropertyValueList.html ShorthandPropSets.html
                        codedisplay.js
               targets/fop/dev configuration.html examples.html
                        extensions.html faq.html faq.pdf fonts.html
                        index.html svg.html
  Added:       targets/fop/design/alt.design alt-design-frameset.html
                        codeframe.html logo.html xml-parsing.pdf
               targets/fop/design/alt.design/images/design/alt.design
                        XML-event-buffer.png
               targets/fop/design/alt.design/properties index.html
                        index.pdf
               targets/fop/dev compiling.html download.html tools.html
                        tools.pdf
  Log:
  Automatic publish at Tue Mar 25 03:34:16 CET 2003 from http://forrestbot.cocoondev.org.
  
  Revision  Changes    Path
  1.21      +86 -104   xml-site/targets/fop/faq.html
  
  Index: faq.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/faq.html,v
  retrieving revision 1.20
  retrieving revision 1.21
  diff -u -r1.20 -r1.21
  --- faq.html	17 Mar 2003 23:29:09 -0000	1.20
  +++ faq.html	25 Mar 2003 02:34:08 -0000	1.21
  @@ -579,15 +579,7 @@
   </ul>
   </li>
   <li>
  -<a name="part_developer-menu"></a><a href="#part_developer">9. General Developer Questions</a>
  -<ul>
  -<li>
  -<a name="javadoc_location-menu"></a><a href="#javadoc_location">How do I get the javadocs for FOP?</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part_help-menu"></a><a href="#part_help">10. General suggestions. How to solve problems.</a>
  +<a name="part_help-menu"></a><a href="#part_help">9. General suggestions. How to solve problems.</a>
   <ul>
   <li>
   <a name="bugs-menu"></a><a href="#bugs">I think I have found a bug in FOP. What should I do?</a>
  @@ -600,13 +592,13 @@
   </li>
   </ul>
   </div>
  -<a name="N101A1"></a>
  +<a name="N10196"></a>
   <h3>Answers</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N101A4"></a><a name="part_general"></a>
  +<a name="N10199"></a><a name="part_general"></a>
   <h4>1. General questions</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N101A8"></a><a name="fop_general"></a>
  +<a name="N1019D"></a><a name="fop_general"></a>
   <h5>1.1. What is FOP?<span style="float: right"><a href="#fop_general-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -620,7 +612,7 @@
           are supported, such as AWT, PCL, text and direct printing.
         </p>
   </div>
  -<a name="N101B7"></a><a name="fop_functions"></a>
  +<a name="N101AC"></a><a name="fop_functions"></a>
   <h5>1.2. What can I do with FOP?<span style="float: right"><a href="#fop_functions-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -637,7 +629,7 @@
             The library can be used in servlets and other Java applications.
           </p>
   </div>
  -<a name="N101C5"></a><a name="fop_acronym"></a>
  +<a name="N101BA"></a><a name="fop_acronym"></a>
   <h5>1.3. What does "FOP" stand for?<span style="float: right"><a href="#fop_acronym-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -646,7 +638,7 @@
             <strong>O</strong>bject <strong>P</strong>rocessor
           </p>
   </div>
  -<a name="N101D6"></a><a name="fop_other_apache"></a>
  +<a name="N101CB"></a><a name="fop_other_apache"></a>
   <h5>1.4. How does FOP interact with other Apache Projects?<span style="float: right"><a href="#fop_other_apache-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -661,7 +653,7 @@
             image</a> into a PDF document.
           </p>
   </div>
  -<a name="N101ED"></a><a name="xsl_def"></a>
  +<a name="N101E2"></a><a name="xsl_def"></a>
   <h5>1.5. What is XSL?<span style="float: right"><a href="#xsl_def-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -672,7 +664,7 @@
             <strong>L</strong>anguage.
           </p>
   </div>
  -<a name="N10206"></a><a name="XSLFO"></a>
  +<a name="N101FB"></a><a name="XSLFO"></a>
   <h5>1.6. What is XSLFO?<span style="float: right"><a href="#XSLFO-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -695,7 +687,7 @@
             Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
           </p>
   </div>
  -<a name="N1021E"></a><a name="XSLT"></a>
  +<a name="N10213"></a><a name="XSLT"></a>
   <h5>1.7. What is XSLT?<span style="float: right"><a href="#XSLT-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -709,7 +701,7 @@
             Synonyms: XSL transformation, XSL:T, XSL style sheet.
           </p>
   </div>
  -<a name="N1022C"></a><a name="contribute"></a>
  +<a name="N10221"></a><a name="contribute"></a>
   <h5>1.8. How can I contribute?<span style="float: right"><a href="#contribute-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -719,10 +711,10 @@
           </p>
   </div>
   </div>
  -<a name="N10238"></a><a name="part_running"></a>
  +<a name="N1022D"></a><a name="part_running"></a>
   <h4>2. Problems running FOP</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N1023C"></a><a name="no_page_master"></a>
  +<a name="N10231"></a><a name="no_page_master"></a>
   <h5>2.1. I get the error: [ERROR]: 'master-reference' for
         'fo:page-sequence'matches no 'simple-page-master' or
         'page-sequence-master'<span style="float: right"><a href="#no_page_master-menu">^</a></span>
  @@ -743,7 +735,7 @@
             See also <a href="relnotes.html">release notes</a>.
           </p>
   </div>
  -<a name="N1024F"></a><a name="NoClassDefFound"></a>
  +<a name="N10244"></a><a name="NoClassDefFound"></a>
   <h5>2.2. I get a NoClassDefFound exception.<span style="float: right"><a href="#NoClassDefFound-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -770,7 +762,7 @@
             Java application, check the classpath of the application.
           </p>
   </div>
  -<a name="N10266"></a><a name="NoSuchMethodException"></a>
  +<a name="N1025B"></a><a name="NoSuchMethodException"></a>
   <h5>2.3. I get a NoSuchMethodException or a NoSuchFieldException
         exception.<span style="float: right"><a href="#NoSuchMethodException-menu">^</a></span>
   </h5>
  @@ -786,7 +778,7 @@
             use a more recent version of Batik.
           </p>
   </div>
  -<a name="N10271"></a><a name="OutOfMemoryException"></a>
  +<a name="N10266"></a><a name="OutOfMemoryException"></a>
   <h5>2.4. I get an OutOfMemoryException.<span style="float: right"><a href="#OutOfMemoryException-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -861,7 +853,7 @@
             ongoing effort, partially addressed in the <a href="dev/index.html">redesign</a>.
           </p>
   </div>
  -<a name="N102A4"></a><a name="MalformedURLException"></a>
  +<a name="N10299"></a><a name="MalformedURLException"></a>
   <h5>2.5. I get a MalformedURLException.<span style="float: right"><a href="#MalformedURLException-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -891,7 +883,7 @@
             URL.
           </p>
   </div>
  -<a name="N102D4"></a><a name="NullPointerException"></a>
  +<a name="N102C9"></a><a name="NullPointerException"></a>
   <h5>2.6. I get an "[ERROR]: null", or a NullPointerException.<span style="float: right"><a href="#NullPointerException-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -922,7 +914,7 @@
             see more detailed information.
           </p>
   </div>
  -<a name="N102E9"></a><a name="fop_hangs"></a>
  +<a name="N102DE"></a><a name="fop_hangs"></a>
   <h5>2.7. FOP hangs. FOP does not exit.<span style="float: right"><a href="#fop_hangs-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -946,7 +938,7 @@
             exec'ing FOP, use the library interface instead.
           </p>
   </div>
  -<a name="N102FF"></a><a name="boxoverflow"></a>
  +<a name="N102F4"></a><a name="boxoverflow"></a>
   <h5>2.8. FOP runs forever, writing lots of "&gt;" to the log.<span style="float: right"><a href="#boxoverflow-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -961,7 +953,7 @@
             remove keep-with-* properties.
           </p>
   </div>
  -<a name="N10307"></a><a name="cannot_find_external-graphics"></a>
  +<a name="N102FC"></a><a name="cannot_find_external-graphics"></a>
   <h5>2.9. FOP cannot find a file for fo:external-graphics.<span style="float: right"><a href="#cannot_find_external-graphics-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -978,7 +970,7 @@
             working directory of the process which runs FOP.
           </p>
   </div>
  -<a name="N10316"></a><a name="fonts_not_found"></a>
  +<a name="N1030B"></a><a name="fonts_not_found"></a>
   <h5>2.10. FOP does not find my fonts.<span style="float: right"><a href="#fonts_not_found-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -995,10 +987,10 @@
           </p>
   </div>
   </div>
  -<a name="N10321"></a><a name="part_output"></a>
  +<a name="N10316"></a><a name="part_output"></a>
   <h4>3. Problems with FOP output</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10325"></a><a name="blank_page_between_page_sequences"></a>
  +<a name="N1031A"></a><a name="blank_page_between_page_sequences"></a>
   <h5>3.1. Why does FOP insert a blank page between my page sequences?<span style="float: right"><a href="#blank_page_between_page_sequences-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1022,7 +1014,7 @@
             <span class="codefrag">force-page-count="no-force"</span>.
           </p>
   </div>
  -<a name="N1033D"></a><a name="png_fails"></a>
  +<a name="N10332"></a><a name="png_fails"></a>
   <h5>3.2. My PNG images don't work.<span style="float: right"><a href="#png_fails-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1040,7 +1032,7 @@
             not available for all platforms.
           </p>
   </div>
  -<a name="N1034F"></a><a name="keep-with"></a>
  +<a name="N10344"></a><a name="keep-with"></a>
   <h5>3.3. Keep-with-next, keep-with-previous, keep-together
         don't work.<span style="float: right"><a href="#keep-with-menu">^</a></span>
   </h5>
  @@ -1075,7 +1067,7 @@
     &lt;/fo:table-body&gt;
   &lt;/fo:table&gt;</pre>
   </div>
  -<a name="N10361"></a><a name="table_missing"></a>
  +<a name="N10356"></a><a name="table_missing"></a>
   <h5>3.4. My tables are missing, or missing their content.<span style="float: right"><a href="#table_missing-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1091,7 +1083,7 @@
             fo:table-with-caption elements, so watch out.
           </p>
   </div>
  -<a name="N1036C"></a><a name="cells_overflow"></a>
  +<a name="N10361"></a><a name="cells_overflow"></a>
   <h5>3.5. Text overflowing table cells and the like is not clipped. Long
           text flows into adjacent cells/block, obscuring stuff there.<span style="float: right"><a href="#cells_overflow-menu">^</a></span>
   </h5>
  @@ -1125,7 +1117,7 @@
             archive</a> for how to perform these tasks.
           </p>
   </div>
  -<a name="N1038E"></a><a name="page_number_align"></a>
  +<a name="N10383"></a><a name="page_number_align"></a>
   <h5>3.6. Page numbers are not properly right aligned.<span style="float: right"><a href="#page_number_align-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1142,7 +1134,7 @@
             problem completely.
           </p>
   </div>
  -<a name="N10399"></a><a name="graphic_not_displayed"></a>
  +<a name="N1038E"></a><a name="graphic_not_displayed"></a>
   <h5>3.7. A graphic is not displayed.<span style="float: right"><a href="#graphic_not_displayed-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1179,7 +1171,7 @@
           
   </ul>
   </div>
  -<a name="N103B3"></a><a name="hypenation_fails"></a>
  +<a name="N103A8"></a><a name="hypenation_fails"></a>
   <h5>3.8. Hyphenation does not work.<span style="float: right"><a href="#hypenation_fails-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1190,10 +1182,10 @@
           </p>
   </div>
   </div>
  -<a name="N103BB"></a><a name="part_embedding"></a>
  +<a name="N103B0"></a><a name="part_embedding"></a>
   <h4>4. Embedding FOP. Using FOP in a servlet.</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N103BF"></a><a name="servlet"></a>
  +<a name="N103B4"></a><a name="servlet"></a>
   <h5>4.1. How do I use FOP in a servlet?<span style="float: right"><a href="#servlet-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1216,7 +1208,7 @@
             for all kinds of details.
           </p>
   </div>
  -<a name="N103D8"></a><a name="servlet_with_xslt"></a>
  +<a name="N103CD"></a><a name="servlet_with_xslt"></a>
   <h5>4.2. How do I use FOP in a servlet with an XSLT
         transformation?<span style="float: right"><a href="#servlet_with_xslt-menu">^</a></span>
   </h5>
  @@ -1272,7 +1264,7 @@
             parameters for the transformation run too.
           </p>
   </div>
  -<a name="N10403"></a><a name="servlet_xslt_params"></a>
  +<a name="N103F8"></a><a name="servlet_xslt_params"></a>
   <h5>4.3. How do I pass parameters to the XSLT transformation?<span style="float: right"><a href="#servlet_xslt_params-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1280,7 +1272,7 @@
             See the end of the answer for the question above.
           </p>
   </div>
  -<a name="N1040B"></a><a name="servlet_nonstd_fonts"></a>
  +<a name="N10400"></a><a name="servlet_nonstd_fonts"></a>
   <h5>4.4. How do I use my own fonts when running FOP from a
         servlet?<span style="float: right"><a href="#servlet_nonstd_fonts-menu">^</a></span>
   </h5>
  @@ -1291,7 +1283,7 @@
             file</a> for further steps.
           </p>
   </div>
  -<a name="N1041A"></a><a name="servlet_baseDir"></a>
  +<a name="N1040F"></a><a name="servlet_baseDir"></a>
   <h5>4.5. How do I set the baseDir property in a servlet environment?<span style="float: right"><a href="#servlet_baseDir-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1308,7 +1300,7 @@
             for caveats.
           </p>
   </div>
  -<a name="N10434"></a><a name="usercfg"></a>
  +<a name="N10429"></a><a name="usercfg"></a>
   <h5>4.6. How do I use a user configuration file from a servlet?<span style="float: right"><a href="#usercfg-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1327,7 +1319,7 @@
             environments.
           </p>
   </div>
  -<a name="N10449"></a><a name="servlet_NoClassDefFound"></a>
  +<a name="N1043E"></a><a name="servlet_NoClassDefFound"></a>
   <h5>4.7. I keep getting NoClassDefFound and other exceptions. How do I
           get FOP working for various servlet engines?<span style="float: right"><a href="#servlet_NoClassDefFound-menu">^</a></span>
   </h5>
  @@ -1347,7 +1339,7 @@
             Websphere 3.5: See next question.
           </p>
   </div>
  -<a name="N10457"></a><a name="websphere_3_5"></a>
  +<a name="N1044C"></a><a name="websphere_3_5"></a>
   <h5>4.8. FOP in IBM Websphere 3.5<span style="float: right"><a href="#websphere_3_5-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1365,7 +1357,7 @@
             restart the application server.
           </p>
   </div>
  -<a name="N1045F"></a><a name="multithreaded"></a>
  +<a name="N10454"></a><a name="multithreaded"></a>
   <h5>4.9. Can FOP be used in multithreaded environments?<span style="float: right"><a href="#multithreaded-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1388,10 +1380,10 @@
           </p>
   </div>
   </div>
  -<a name="N1046A"></a><a name="part_svg"></a>
  +<a name="N1045F"></a><a name="part_svg"></a>
   <h4>5. Batik/SVG specific questions</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N1046E"></a><a name="svg_text"></a>
  +<a name="N10463"></a><a name="svg_text"></a>
   <h5>5.1. SVG text rendered in bad quality. How do I put SVG text as text
         into PDF?<span style="float: right"><a href="#svg_text-menu">^</a></span>
   </h5>
  @@ -1423,7 +1415,7 @@
             This does not work for other renderers.
           </p>
   </div>
  -<a name="N1048E"></a><a name="svg_headless"></a>
  +<a name="N10483"></a><a name="svg_headless"></a>
   <h5>5.2. How do I use FOP with SVG on headless servers?<span style="float: right"><a href="#svg_headless-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1456,7 +1448,7 @@
           
   </ul>
   </div>
  -<a name="N104A9"></a><a name="svghangs"></a>
  +<a name="N1049E"></a><a name="svghangs"></a>
   <h5>5.3. FOP does not exit if a SVG is included.<span style="float: right"><a href="#svghangs-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1466,7 +1458,7 @@
             System.exit(0) somewhere.
           </p>
   </div>
  -<a name="N104B1"></a><a name="svg_url"></a>
  +<a name="N104A6"></a><a name="svg_url"></a>
   <h5>5.4. I have problems with SVG referring to gradients etc. using
           "uri(#stuff)". I get a MalformedURLException.<span style="float: right"><a href="#svg_url-menu">^</a></span>
   </h5>
  @@ -1520,10 +1512,10 @@
   </p>
   </div>
   </div>
  -<a name="N104DD"></a><a name="part_pdf"></a>
  +<a name="N104D2"></a><a name="part_pdf"></a>
   <h4>6. PDF specific (includes Acrobat peculiarities)</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N104E1"></a><a name="pdf_embed_font"></a>
  +<a name="N104D6"></a><a name="pdf_embed_font"></a>
   <h5>6.1. How do I embed fonts in PDF?<span style="float: right"><a href="#pdf_embed_font-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1532,7 +1524,7 @@
             about embedding fonts.
           </p>
   </div>
  -<a name="N104ED"></a><a name="pdf_characters"></a>
  +<a name="N104E2"></a><a name="pdf_characters"></a>
   <h5>6.2. Some characters are not displayed, or displayed incorrectly, or
         displayed as &ldquo;#&rdquo;.<span style="float: right"><a href="#pdf_characters-menu">^</a></span>
   </h5>
  @@ -1557,7 +1549,7 @@
           </p>
   <pre class="code">&lt;fo:inline font-family="Helvetica"&gt;&amp;#x2205;&lt;/fo:inline&gt;</pre>
   </div>
  -<a name="N1050B"></a><a name="PDF-postprocess"></a>
  +<a name="N10500"></a><a name="PDF-postprocess"></a>
   <h5>6.3. What tools are available for post-processing my PDF document?<span style="float: right"><a href="#PDF-postprocess-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1567,10 +1559,10 @@
               The most popular one that we are aware of is <a href="http://www.lowagie.com/iText">iText</a>, which has tools
               for adding security features, document properties, watermarks, and
               many other features to PDF files. FOP and iText can be integrated
  -            into one Java application, see sample code for <a href="pdf-security.html">encryption</a>.
  +            into one Java application, see sample code for <a href="#pdf-security">encryption</a>.
               The bad news is that iText swallows PDF bookmarks.
             </li>
  -          
  +
             
   <li>
               You can use Adobe Acrobat (the full version, not the Reader) to
  @@ -1579,7 +1571,7 @@
           
   </ul>
   </div>
  -<a name="N10521"></a><a name="pdf-security"></a>
  +<a name="N10516"></a><a name="pdf-security"></a>
   <h5>6.4. How do I add security features (encryption, disable printing)
         to my PDF document?<span style="float: right"><a href="#pdf-security-menu">^</a></span>
   </h5>
  @@ -1608,7 +1600,7 @@
       int n = reader.getNumberOfPages();
       Document document = new Document(reader.getPageSizeWithRotation(1));
       PdfWriter writer = PdfWriter.getInstance(document, outfile);
  -    writer.setEncryption(PdfWriter.STRENGTH40BITS, "pdf", null, 
  +    writer.setEncryption(PdfWriter.STRENGTH40BITS, "pdf", null,
         PdfWriter.AllowCopy);
       document.open();
       PdfContentByte cb = writer.getDirectContent();
  @@ -1640,7 +1632,7 @@
             password, encryption strength and other parameters.
           </p>
   </div>
  -<a name="N10537"></a><a name="pdf_doc_properties"></a>
  +<a name="N1052C"></a><a name="pdf_doc_properties"></a>
   <h5>6.5. How do I add document properties (title, author, etc.) to my
         PDF document?<span style="float: right"><a href="#pdf_doc_properties-menu">^</a></span>
   </h5>
  @@ -1649,7 +1641,7 @@
           include those mentioned in the <a href="#PDF-postprocess">PDF
           Post-Processing FAQ</a>.</p>
   </div>
  -<a name="N10543"></a><a name="pdf_watermark"></a>
  +<a name="N10538"></a><a name="pdf_watermark"></a>
   <h5>6.6. How do I add watermarks to my PDF document?<span style="float: right"><a href="#pdf_watermark-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1678,7 +1670,7 @@
           
   </ul>
   </div>
  -<a name="N1055B"></a><a name="pdf_print_contortion"></a>
  +<a name="N10550"></a><a name="pdf_print_contortion"></a>
   <h5>6.7. The PDF is printed contorted!<span style="float: right"><a href="#pdf_print_contortion-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1690,7 +1682,7 @@
             settings too.
           </p>
   </div>
  -<a name="N10563"></a><a name="pdf_bookmark_display"></a>
  +<a name="N10558"></a><a name="pdf_bookmark_display"></a>
   <h5>6.8. How do I control the Acrobat bookmark display?<span style="float: right"><a href="#pdf_bookmark_display-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1701,10 +1693,10 @@
           </p>
   </div>
   </div>
  -<a name="N1056F"></a><a name="part_iex"></a>
  +<a name="N10564"></a><a name="part_iex"></a>
   <h4>7. IEx specific stuff</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10573"></a><a name="iex_servlet_multiple"></a>
  +<a name="N10568"></a><a name="iex_servlet_multiple"></a>
   <h5>7.1. The FOP servlet is called multiple times!<span style="float: right"><a href="#iex_servlet_multiple-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1740,7 +1732,7 @@
           
   </ul>
   </div>
  -<a name="N10593"></a><a name="iex_pdf_print_from_browser"></a>
  +<a name="N10588"></a><a name="iex_pdf_print_from_browser"></a>
   <h5>7.2. How do I print PDF directly from the browser?<span style="float: right"><a href="#iex_pdf_print_from_browser-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1764,10 +1756,10 @@
           </p>
   </div>
   </div>
  -<a name="N105A4"></a><a name="part_input"></a>
  +<a name="N10599"></a><a name="part_input"></a>
   <h4>8. More general questions regarding XSLT and XSLFO and basic XML</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N105A8"></a><a name="fo_center"></a>
  +<a name="N1059D"></a><a name="fo_center"></a>
   <h5>8.1. (FO) How do I vertically center an image or a table (or
         whatever)?<span style="float: right"><a href="#fo_center-menu">^</a></span>
   </h5>
  @@ -1803,7 +1795,7 @@
     &lt;/fo:page-sequence&gt;
   &lt;/fo:root&gt;</pre>
   </div>
  -<a name="N105B4"></a><a name="fo_center_table_horizon"></a>
  +<a name="N105A9"></a><a name="fo_center_table_horizon"></a>
   <h5>8.2. (FO) How do I center a table horizontally?<span style="float: right"><a href="#fo_center_table_horizon-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1841,7 +1833,7 @@
             If your table is more complicated, or if defining borders on individual cells becomes too much work, use the code above and nest your table within the moddle cell.
           </p>
   </div>
  -<a name="N105C3"></a><a name="fo_page_outer"></a>
  +<a name="N105B8"></a><a name="fo_page_outer"></a>
   <h5>8.3. (FO) How to get page numbers printed on the "outer side" of the
           page (for books, for example)?<span style="float: right"><a href="#fo_page_outer-menu">^</a></span>
   </h5>
  @@ -1851,7 +1843,7 @@
             pages</a>.
           </p>
   </div>
  -<a name="N105CF"></a><a name="oddeven"></a>
  +<a name="N105C4"></a><a name="oddeven"></a>
   <h5>8.4. (FO) How do I use different static content for odd and even
         pages?<span style="float: right"><a href="#oddeven-menu">^</a></span>
   </h5>
  @@ -1907,7 +1899,7 @@
     &lt;/fo:page-sequence&gt;
   &lt;/fo:root&gt;</pre>
   </div>
  -<a name="N105E2"></a><a name="fo_first_page_header"></a>
  +<a name="N105D7"></a><a name="fo_first_page_header"></a>
   <h5>8.5. (FO) How do I get a special header on the first page?<span style="float: right"><a href="#fo_first_page_header-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -1958,7 +1950,7 @@
     &lt;/fo:page-sequence&gt;
   &lt;/fo:root&gt;</pre>
   </div>
  -<a name="N105EE"></a><a name="fo_omit_headers"></a>
  +<a name="N105E3"></a><a name="fo_omit_headers"></a>
   <h5>8.6. (FO) How do I omit my headers on a blank page? How do I write
         "This page is left blank" on an intentionally blank page?<span style="float: right"><a href="#fo_omit_headers-menu">^</a></span>
   </h5>
  @@ -2017,7 +2009,7 @@
     &lt;/fo:page-sequence&gt;
   &lt;/fo:root&gt;</pre>
   </div>
  -<a name="N10600"></a><a name="fo_special_symbols"></a>
  +<a name="N105F5"></a><a name="fo_special_symbols"></a>
   <h5>8.7. (FO) How do I print an Euro sign, a checkbox or other some other
         special symbols?<span style="float: right"><a href="#fo_special_symbols-menu">^</a></span>
   </h5>
  @@ -2050,7 +2042,7 @@
             Alternative: Use an embedded graphic: GIF, PNG, SVG, whatever.
           </p>
   </div>
  -<a name="N10627"></a><a name="fo_preformat"></a>
  +<a name="N1061C"></a><a name="fo_preformat"></a>
   <h5>8.8. (FO) How do I keep linebreaks and hard spaces? How do I get
           preformatted text displayed as expected?<span style="float: right"><a href="#fo_preformat-menu">^</a></span>
   </h5>
  @@ -2063,7 +2055,7 @@
             actually a bug, expect this to be changed).
           </p>
   </div>
  -<a name="N10637"></a><a name="fo_total_pages"></a>
  +<a name="N1062C"></a><a name="fo_total_pages"></a>
   <h5>8.9. (FO) How do I print the total number of pages, like in "page 1
         of 12"<span style="float: right"><a href="#fo_total_pages-menu">^</a></span>
   </h5>
  @@ -2139,7 +2131,7 @@
             the first run by the actual page count may change it.
           </p>
   </div>
  -<a name="N10663"></a><a name="fo_region_overlap"></a>
  +<a name="N10658"></a><a name="fo_region_overlap"></a>
   <h5>8.10. (FO) The header overlaps body content. The body extends into
         the footer.<span style="float: right"><a href="#fo_region_overlap-menu">^</a></span>
   </h5>
  @@ -2160,7 +2152,7 @@
             The overlap effect can be used creatively for some purposes.
           </p>
   </div>
  -<a name="N10671"></a><a name="fo_lines"></a>
  +<a name="N10666"></a><a name="fo_lines"></a>
   <h5>8.11. (FO) How do I get lines in the document, as separators, side
         bars or folding marks?<span style="float: right"><a href="#fo_lines-menu">^</a></span>
   </h5>
  @@ -2186,7 +2178,7 @@
           
   </ul>
   </div>
  -<a name="N10689"></a><a name="FO-validate"></a>
  +<a name="N1067E"></a><a name="FO-validate"></a>
   <h5>8.12. (FO) How do I validate my FO document?<span style="float: right"><a href="#FO-validate-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  @@ -2205,7 +2197,7 @@
             document for instructions on how to use it.
           </p>
   </div>
  -<a name="N106A0"></a><a name="xml_non-breaking_space"></a>
  +<a name="N10695"></a><a name="xml_non-breaking_space"></a>
   <h5>8.13. (XML) There are complaints about &amp;nbsp;. How
           do I get a non-breaking space in FO?<span style="float: right"><a href="#xml_non-breaking_space-menu">^</a></span>
   </h5>
  @@ -2215,7 +2207,7 @@
             which declares the entity.
           </p>
   </div>
  -<a name="N106AB"></a><a name="xml_undefined_entities"></a>
  +<a name="N106A0"></a><a name="xml_undefined_entities"></a>
   <h5>8.14. (XML) There are complaints about undefined entities, for example
           about &amp;uuml; which used to work in HTML. How do I enter
           special characters like in HTML?<span style="float: right"><a href="#xml_undefined_entities-menu">^</a></span>
  @@ -2229,7 +2221,7 @@
           
   </p>
   </div>
  -<a name="N106BA"></a><a name="xml_illegal_entities"></a>
  +<a name="N106AF"></a><a name="xml_illegal_entities"></a>
   <h5>8.15. (XML) There are complaints about illegal characters and entities
         in the input.<span style="float: right"><a href="#xml_illegal_entities-menu">^</a></span>
   </h5>
  @@ -2249,7 +2241,7 @@
               file format.
           </p>
   </div>
  -<a name="N106CC"></a><a name="xml_illegal_chars"></a>
  +<a name="N106C1"></a><a name="xml_illegal_chars"></a>
   <h5>8.16. (XML) There are complaints about illegal bytes or characters in
         the input. There are odd characters in the result.<span style="float: right"><a href="#xml_illegal_chars-menu">^</a></span>
   </h5>
  @@ -2263,23 +2255,11 @@
           </p>
   </div>
   </div>
  -<a name="N106D8"></a><a name="part_developer"></a>
  -<h4>9. General Developer Questions</h4>
  +<a name="N106CD"></a><a name="part_help"></a>
  +<h4>9. General suggestions. How to solve problems.</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N106DC"></a><a name="javadoc_location"></a>
  -<h5>9.1. How do I get the javadocs for FOP?<span style="float: right"><a href="#javadoc_location-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>Currently, the only way to get FOP javadocs is to <a href="download.html">
  -        Download the source code</a> and then <a href="compiling.html">Build
  -        FOP</a> using the ant build task "javadocs".</p>
  -</div>
  -</div>
  -<a name="N106EC"></a><a name="part_help"></a>
  -<h4>10. General suggestions. How to solve problems.</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N106F0"></a><a name="bugs"></a>
  -<h5>10.1. I think I have found a bug in FOP. What should I do?<span style="float: right"><a href="#bugs-menu">^</a></span>
  +<a name="N106D1"></a><a name="bugs"></a>
  +<h5>9.1. I think I have found a bug in FOP. What should I do?<span style="float: right"><a href="#bugs-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
   <p>
  @@ -2287,12 +2267,14 @@
             bugs already reported and how to report new ones.
           </p>
   </div>
  -<a name="N106FC"></a><a name="postquestions"></a>
  -<h5>10.2. I have questions that are not addressed in this FAQ. Where
  +<a name="N106DD"></a><a name="postquestions"></a>
  +<h5>9.2. I have questions that are not addressed in this FAQ. Where
         should I post them?<span style="float: right"><a href="#postquestions-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
   <ul>
  +          
  +<li>If your question is a development-related question, please see the <a href="dev/faq.html">Developer FAQs</a>.</li>
             
   <li>
               If you have a runtime exception or other runtime problem:
  
  
  
  1.9       +2364 -2602xml-site/targets/fop/faq.pdf
  
  	<<Binary file>>
  
  
  1.31      +21 -20    xml-site/targets/fop/implemented.html
  
  Index: implemented.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/implemented.html,v
  retrieving revision 1.30
  retrieving revision 1.31
  diff -u -r1.30 -r1.31
  --- implemented.html	11 Mar 2003 15:34:37 -0000	1.30
  +++ implemented.html	25 Mar 2003 02:34:09 -0000	1.31
  @@ -326,7 +326,7 @@
   <a href="#2%29+Properties">2) Properties</a>
   </li>
   <li>
  -<a href="#3%29SVG+Support">3)SVG Support</a>
  +<a href="#3%29+SVG+Support">3) SVG Support</a>
   </li>
   </ul>
   </li>
  @@ -339,16 +339,17 @@
   <h4>What's Implemented?</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>The following formatting objects and properties of the XSL-FO 1.0
  -         W3C Recommandation are implemented. Please have also a look at the
  +         W3C Recommendation are implemented. Please also have a look at the
            section on <a target="_top" href="limitations.html">limitations</a>.
         </p>
   </div>
   <a name="N101D2"></a><a name="1%29+Formatting+Objects"></a>
   <h4>1) Formatting Objects</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>This section follows the table "B Formatting Object Summary" in the xsl:fo specification. At the
  -       end of each sub-section you find listed what is not implemented.</p>
  -<a name="N101DB"></a><a name="B.1+Declaration+and+Pagination+and+Layout+Formatting+Objects"></a>
  +<p>This section follows the tables in 
  +      <a target="_top" href="http://www.w3.org/TR/2001/REC-xsl-20011015/sliceB.html#FO-summary">Appendix B, "Formatting Object Summary"</a> of the XSL-FO specification. 
  +      Items that are not currently implemented are listed at the end of each sub-section.</p>
  +<a name="N101DF"></a><a name="B.1+Declaration+and+Pagination+and+Layout+Formatting+Objects"></a>
   <h5>B.1 Declaration and Pagination and Layout Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -388,7 +389,7 @@
   </ul>
   <p>Not implemented: declarations, color-profile, title</p>
   </div>
  -<a name="N10218"></a><a name="B.2+Block+Formatting+Objects"></a>
  +<a name="N1021C"></a><a name="B.2+Block+Formatting+Objects"></a>
   <h5>B.2 Block Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -399,7 +400,7 @@
         
   </ul>
   </div>
  -<a name="N10228"></a><a name="B.3+Inline+Formatting+Objects"></a>
  +<a name="N1022C"></a><a name="B.3+Inline+Formatting+Objects"></a>
   <h5>B.3 Inline Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -422,7 +423,7 @@
   </ul>
   <p>Not implemented: bidi-override, initial-property-set, inline-container</p>
   </div>
  -<a name="N1024D"></a><a name="B.4+Table+Formatting+Objects"></a>
  +<a name="N10251"></a><a name="B.4+Table+Formatting+Objects"></a>
   <h5>B.4 Table Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -444,7 +445,7 @@
   </ul>
   <p>Not implemented: table-and-caption, table-caption </p>
   </div>
  -<a name="N1026F"></a><a name="B.5+List+Formatting+Objects"></a>
  +<a name="N10273"></a><a name="B.5+List+Formatting+Objects"></a>
   <h5>B.5 List Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -459,7 +460,7 @@
         
   </ul>
   </div>
  -<a name="N10285"></a><a name="B.6+Link+and+Multi+Formatting+Objects"></a>
  +<a name="N10289"></a><a name="B.6+Link+and+Multi+Formatting+Objects"></a>
   <h5>B.6 Link and Multi Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -470,7 +471,7 @@
   <p>Not implemented: multi-switch, multi-case, multi-toggle,
            multi-properties, multi-property-set</p>
   </div>
  -<a name="N10295"></a><a name="B.7+Out-of-line+Formatting+Objects"></a>
  +<a name="N10299"></a><a name="B.7+Out-of-line+Formatting+Objects"></a>
   <h5>B.7 Out-of-line Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -482,7 +483,7 @@
   </ul>
   <p>Not implemented: float</p>
   </div>
  -<a name="N102A8"></a><a name="B.8+Other+Formatting+Objects"></a>
  +<a name="N102AC"></a><a name="B.8+Other+Formatting+Objects"></a>
   <h5>B.8 Other Formatting Objects</h5>
   <div style="margin-left: 0 ; border: 2px">
   <ul>
  @@ -494,10 +495,10 @@
   </ul>
   </div>
   </div>
  -<a name="N102B9"></a><a name="2%29+Properties"></a>
  +<a name="N102BD"></a><a name="2%29+Properties"></a>
   <h4>2) Properties</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<p>Property values can be computed. Compound properties are also understood by Fop.</p>
  +<p>Property values can be computed. Compound properties are also understood by FOP.</p>
   <ul>
         
   <li>background-color </li>
  @@ -729,17 +730,17 @@
   </ul>
   <p>All other properties are not implemented.</p>
   </div>
  -<a name="N1041C"></a><a name="3%29SVG+Support"></a>
  -<h4>3)SVG Support</h4>
  +<a name="N10420"></a><a name="3%29+SVG+Support"></a>
  +<h4>3) SVG Support</h4>
   <div style="margin-left: 0 ; border: 2px">
   <p>
   FOP uses <a target="_top" href="http://xml.apache.org/batik/">Batik</a> directly for its SVG support. Therefore FOP supports the same
  -elements and properties as are supported by Batik. As FOP is designed for
  -rendering to a static medium then only static SVG is rendered.
  +elements and properties as are supported by Batik. Because FOP is designed for
  +rendering to a static medium, only static SVG is supported.
   </p>
   <p>
  -Due to some limitations in PDF some SVG images, particularly ones with effects
  -or transparency, may not come out correctly. The images should still be renderedcorrectly for the AWT and Print renderers.
  +Due to certain PDF limitations, some SVG images, particularly those with filter effects
  +or transparency, may not come out correctly.  However, these images should still be rendered correctly by the AWT and Print renderers.
   </p>
   </div>
   </div>
  
  
  
  1.6       +113 -113  xml-site/targets/fop/implemented.pdf
  
  	<<Binary file>>
  
  
  1.13      +11 -9     xml-site/targets/fop/relnotes.html
  
  Index: relnotes.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/relnotes.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- relnotes.html	11 Mar 2003 15:34:38 -0000	1.12
  +++ relnotes.html	25 Mar 2003 02:34:09 -0000	1.13
  @@ -327,17 +327,17 @@
   <a name="N101BE"></a><a name="FOP+0.20.5"></a>
   <h3>FOP 0.20.5</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<p>This is the last planed release in the 0.20.x series (aka maintenance branch).</p>
  +<p>This is the last planned release in the 0.20.x series (aka maintenance branch).</p>
   <p>Important changes since the last release (0.20.4):</p>
   <ul>
       
   <li>Some hyphenation patterns (cs, da, de, de_DR, el, en, en_US, fr, nl,
  -        no, pt, ru, sk, tr) have been removed due to licensing reasons. 
  -        We hope to resolve this issue until the final release.
  +        no, pt, ru, sk, tr) have been removed due to licensing reasons.
  +        We hope to resolve this issue before the final release.
           (English hyphenation is still available as en_GB)
       </li>
       
  -<li>Documentation is done with <a href="http://xml.apache.org/forrest/">
  +<li>Documentation is now built with <a href="http://xml.apache.org/forrest/">
           Forrest</a> (version 0.3). You need to install Forrest if you want build the docs
           yourself. (See
           <a href="http://xml.apache.org/forrest/your-project.html">Using Forrest</a>)
  @@ -347,14 +347,16 @@
           Xerces to version 2.2.1, Xalan to version 2.4.1 and Batik to version 1.5beta4.
       </li>
       
  -<li>Fop has been compiled with Jimi support this time but you still have to download
  -        <a href="http://java.sun.com/products/jimi/">Jimi</a>, extract the archive,
  +<li>FOP has been compiled with Jimi support, but Jimi is not included in the
  +        FOP distribution. To use it, first download
  +        <a href="http://java.sun.com/products/jimi/">Jimi</a>, then extract
  +        the archive, then
           copy JimiProClasses.zip to FOP's lib dir and rename it to jimi-1.0.jar.
       </li>
       
  -<li>Fop has been compiled with
  -        <a href="http://java.sun.com/products/java-media/jai/JAI">JAI</a>
  -        support. For using JAI you just need to install it.
  +<li>FOP has been compiled with JAI support, but JAI is not included in the
  +        FOP distribution. To use it, simply install
  +        <a href="http://java.sun.com/products/java-media/jai">JAI</a>.
       </li>
       
   <li>Links in PDF won't generate multiple link rectangles anymore. If this causes
  
  
  
  1.6       +136 -162  xml-site/targets/fop/relnotes.pdf
  
  	<<Binary file>>
  
  
  1.10      +59 -59    xml-site/targets/fop/design/architecture.html
  
  Index: architecture.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/architecture.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- architecture.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ architecture.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -2,7 +2,7 @@
   <html>
   <head>
   <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>Architecture</title>
  +<title>Implementation Overview</title>
   <link type="text/css" href="../skin/page.css" rel="stylesheet">
   </head>
   <body text="#000000" bgcolor="#FFFFFF">
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<span class="sel"><font color="#ffcc00">Architecture</font></span>
  +<span class="sel"><font color="#ffcc00">Architecture Implementation</font></span>
   </li>
       
   </ul>
  @@ -247,21 +247,21 @@
   <table class="title" summary="">
   <tr>
   <td valign="middle">
  -<h1>Architecture</h1>
  +<h1>Implementation Overview</h1>
   </td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="architecture.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
             PDF</a></td>
   </tr>
   </table>
  -<h3>Architecture information for FOP</h3>
  +<h3>Following a Document Through FOP</h3>
   <p>
   <font size="-2">by&nbsp;Arved Sandstrom</font>
   </p>
   <ul class="minitoc">
   <li>
  -<a href="#FOP+Mechanics">FOP Mechanics</a>
  -<ul class="minitoc">
  +<a href="#Overview">Overview</a>
  +</li>
   <li>
  -<a href="#Introduction">Introduction</a>
  +<a href="#Startup">Startup</a>
   </li>
   <li>
   <a href="#Formatting+Object+Tree">Formatting Object Tree</a>
  @@ -276,71 +276,72 @@
   <a href="#Rendering">Rendering</a>
   </li>
   </ul>
  -</li>
  -</ul>
  -
  -
  -<a name="N101C8"></a><a name="FOP+Mechanics"></a>
  -<h3>FOP Mechanics</h3>
  +    
  +<p>The purpose of this document is to tie together the FOP design (interface) with some of the key points where control is passed within FOP (implementation), so that developers can quickly find the section of code that is relevant to their needs. The process described is for a "typical" command-line document. All class names are in org.apache.fop unless otherwise designated.</p>
  +    
  +<a name="N101CB"></a><a name="Overview"></a>
  +<h3>Overview</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N101CE"></a><a name="Introduction"></a>
  -<h4>Introduction</h4>
  +<p>The input FO document is sent to the FO tree builder via SAX events. Fragments of an FO Tree are built from this process. As each page-sequence element is completed, it is passed to a layout processor, which in turn converts it into an Area Tree. The Area Tree is then given to the Renderer, which converts it into a stream of data containing the output document. The sections below will provide additional details.</p>
  +</div>
  +    
  +<a name="N101D5"></a><a name="Startup"></a>
  +<h3>Startup</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -The overall process is controlled by <em>org.apache.fop.apps.Driver</em>.
  -This class handles the FO Tree building, structure handler, renderers, output and logging.
  -</p>
  -<p>
  -The process in general is that the FO document is sent to the tree
  -builder via SAX events. This creates an FO Tree. The FO Tree is then
  -handled by the layout processor which converts the FO Tree into an area
  -tree. This area tree is then given to the renderer and the renderer converts
  -the area tree into a stream of data containing the output document.
  -</p>
  +<ul>
  +        
  +<li>The job starts in <em>apps.Fop.main()</em>.</li>
  +        
  +<li>Control is passed to <em>apps.CommandLineStarter.run()</em>.</li>
  +        
  +<li>Control is passed to <em>apps.Driver.render()</em>. This class fires up a SAX parser, the events from which indirectly control the remaining processing, including building the FO Tree, building the Area Tree, rendering, output and logging.</li>
  +      
  +</ul>
   </div>
  -<a name="N101DE"></a><a name="Formatting+Object+Tree"></a>
  -<h4>Formatting Object Tree</h4>
  +    
  +<a name="N101F1"></a><a name="Formatting+Object+Tree"></a>
  +<h3>Formatting Object Tree</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -The class <em>org.apache.fop.fo.FOTreeBuilder</em> is responsible for
  -actually constructing the FO tree. The key SAX events used are </p>
  -<p>
  -<span class="codefrag">startElement()</span>,</p>
  -<p>
  -<span class="codefrag">endElement()</span> and <span class="codefrag">characters()</span>.</p>
  +<ul>
  +        
  +<li>The SAX events that the parser creates are handled by <em>fo.FOTreeBuilder</em>, which uses <span class="codefrag">startElement()</span>, <span class="codefrag">endElement()</span>, and <span class="codefrag">characters()</span> methods to build the FO Tree.</li>
  +        
  +<li>
  +<em>fo.FOTreeBuilder.endElement()</em> runs the end() method for each node as it is created. The <em>fo.pagination.PageSequence</em> class overrides this end() method to run <em>apps.LayoutHandler.endPageSequence()</em>.</li>
  +        
  +<li>
  +<em>apps.LayoutHandler.endPageSequence()</em> in turn runs <em>fo.pagination.PageSequence.format()</em>, which drives the layout process.</li>
  +      
  +</ul>
   </div>
  -<a name="N101F8"></a><a name="Layout"></a>
  -<h4>Layout</h4>
  +    
  +<a name="N1021D"></a><a name="Layout"></a>
  +<h3>Layout</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -The layout managers handle the layout. They take an FO tree and construct
  -the area tree.
  -The layout process involves finding out where line breaks and page
  -breaks should be made. The areas are then added to the page. The
  -static areas can the be done for all the static regions.
  -Completed pages are then added to the area tree, the area tree can
  -then deal with the page.
  -</p>
  +<p>There are layout managers for each type of layout decision.
  +They take an FO Tree as input and build a laid-out Area Tree from it.
  +The layout process involves finding out where line breaks and page breaks should be made, then creating the areas on the page.
  +Static areas can then be added for any static regions.
  +As pages are completed, they are added to the Area Tree.</p>
   </div>
  -<a name="N10202"></a><a name="Area+Tree"></a>
  -<h4>Area Tree</h4>
  +    
  +<a name="N10227"></a><a name="Area+Tree"></a>
  +<h3>Area Tree</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<p>
  -The area tree is a data structure designed to hold the page areas.
  +<p>The area tree is a data structure designed to hold the page areas.
   These pages are then filled with the page regions and various areas.
   The area tree is used primarily as a minimal structure that can be rendered
  -by the renderers.
  -</p>
  -<p>
  -The area tree is supported by an area tree model. This model
  +by the renderers.</p>
  +<p>The area tree is supported by an area tree model. This model
   handles the adding of pages to the area tree. It also handles
   page sequence starts, document level extensions, id references
   and unresolved id areas. This model allows the pages to be handled
   directly by a renderer or to store the pages for later use.
   </p>
   </div>
  -<a name="N1020F"></a><a name="Rendering"></a>
  -<h4>Rendering</h4>
  +    
  +<a name="N10234"></a><a name="Rendering"></a>
  +<h3>Rendering</h3>
   <div style="margin-left: 0 ; border: 2px">
   <p>
   The renderer receives pages from the area tree and renders those pages.
  @@ -354,12 +355,11 @@
   <p>
   When rendering a page it takes the page and renders each page region.
   The main work for a renderer implementation is to handle the viewports
  -and inline areas. The inline areas need to be dran on the page in the
  +and inline areas. The inline areas need to be drawn on the page in the
   correct place.
   </p>
   </div>
  -</div>
  -    
  +  
   </div>
   </td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
   </tr>
  
  
  
  1.5       +68 -69    xml-site/targets/fop/design/architecture.pdf
  
  	<<Binary file>>
  
  
  1.7       +1 -1      xml-site/targets/fop/design/areas.html
  
  Index: areas.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/areas.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- areas.html	11 Mar 2003 15:34:40 -0000	1.6
  +++ areas.html	25 Mar 2003 02:34:10 -0000	1.7
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.8       +1 -1      xml-site/targets/fop/design/breakpos.html
  
  Index: breakpos.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/breakpos.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- breakpos.html	11 Mar 2003 15:34:40 -0000	1.7
  +++ breakpos.html	25 Mar 2003 02:34:10 -0000	1.8
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.11      +1 -1      xml-site/targets/fop/design/embedding.html
  
  Index: embedding.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/embedding.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- embedding.html	11 Mar 2003 15:34:40 -0000	1.10
  +++ embedding.html	25 Mar 2003 02:34:10 -0000	1.11
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.9       +1 -1      xml-site/targets/fop/design/extending.html
  
  Index: extending.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/extending.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- extending.html	11 Mar 2003 15:34:40 -0000	1.8
  +++ extending.html	25 Mar 2003 02:34:10 -0000	1.9
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/fotree.html
  
  Index: fotree.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/fotree.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- fotree.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ fotree.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.11      +1 -1      xml-site/targets/fop/design/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/index.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- index.html	11 Mar 2003 15:34:40 -0000	1.10
  +++ index.html	25 Mar 2003 02:34:10 -0000	1.11
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/layout.html
  
  Index: layout.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/layout.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- layout.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ layout.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/optimise.html
  
  Index: optimise.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/optimise.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- optimise.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ optimise.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/properties.html
  
  Index: properties.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/properties.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- properties.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ properties.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/renderers.html
  
  Index: renderers.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/renderers.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- renderers.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ renderers.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.10      +1 -1      xml-site/targets/fop/design/useragent.html
  
  Index: useragent.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/useragent.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- useragent.html	11 Mar 2003 15:34:40 -0000	1.9
  +++ useragent.html	25 Mar 2003 02:34:10 -0000	1.10
  @@ -142,7 +142,7 @@
   <ul>
         
   <li>
  -<a href="architecture.html">Architecture</a>
  +<a href="architecture.html">Architecture Implementation</a>
   </li>
       
   </ul>
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/FOPropertySets.html
  
  Index: FOPropertySets.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/FOPropertySets.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.5       +0 -0      xml-site/targets/fop/design/alt.design/FoXMLEvent.html
  
  Index: FoXMLEvent.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/FoXMLEvent.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  
  
  
  1.5       +0 -0      xml-site/targets/fop/design/alt.design/SyncedFoXmlEventsBuffer.html
  
  Index: SyncedFoXmlEventsBuffer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/SyncedFoXmlEventsBuffer.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  
  
  
  1.5       +0 -0      xml-site/targets/fop/design/alt.design/XMLNamespaces.html
  
  Index: XMLNamespaces.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/XMLNamespaces.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  
  
  
  1.4       +0 -0      xml-site/targets/fop/design/alt.design/codedisplay.js
  
  Index: codedisplay.js
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/codedisplay.js,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  
  
  
  1.4       +0 -0      xml-site/targets/fop/design/alt.design/alt-design-frameset.html
  
  
  
  
  1.3       +0 -0      xml-site/targets/fop/design/alt.design/codeframe.html
  
  
  
  
  1.5       +0 -0      xml-site/targets/fop/design/alt.design/logo.html
  
  
  
  
  1.5       +0 -0      xml-site/targets/fop/design/alt.design/xml-parsing.pdf
  
  	<<Binary file>>
  
  
  1.3       +0 -0      xml-site/targets/fop/design/alt.design/images/design/alt.design/XML-event-buffer.png
  
  	<<Binary file>>
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/AbstractPropertyValue.html
  
  Index: AbstractPropertyValue.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/AbstractPropertyValue.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/FOAttributes.html
  
  Index: FOAttributes.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/FOAttributes.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropNames.html
  
  Index: PropNames.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropNames.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/Property.html
  
  Index: Property.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/Property.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertyConsts.html
  
  Index: PropertyConsts.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyConsts.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertyParser.html
  
  Index: PropertyParser.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyParser.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertySets.html
  
  Index: PropertySets.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertySets.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertyTokenizer.html
  
  Index: PropertyTokenizer.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyTokenizer.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertyValue.html
  
  Index: PropertyValue.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyValue.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/PropertyValueList.html
  
  Index: PropertyValueList.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/PropertyValueList.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.14      +0 -0      xml-site/targets/fop/design/alt.design/properties/ShorthandPropSets.html
  
  Index: ShorthandPropSets.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/ShorthandPropSets.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  
  
  
  1.4       +0 -0      xml-site/targets/fop/design/alt.design/properties/codedisplay.js
  
  Index: codedisplay.js
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/design/alt.design/properties/codedisplay.js,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  
  
  
  1.6       +0 -0      xml-site/targets/fop/design/alt.design/properties/index.html
  
  
  
  
  1.3       +0 -0      xml-site/targets/fop/design/alt.design/properties/index.pdf
  
  	<<Binary file>>
  
  
  1.8       +4 -0      xml-site/targets/fop/dev/configuration.html
  
  Index: configuration.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/configuration.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- configuration.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ configuration.html	25 Mar 2003 02:34:12 -0000	1.8
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.8       +4 -0      xml-site/targets/fop/dev/examples.html
  
  Index: examples.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/examples.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- examples.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ examples.html	25 Mar 2003 02:34:12 -0000	1.8
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.8       +4 -0      xml-site/targets/fop/dev/extensions.html
  
  Index: extensions.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/extensions.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- extensions.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ extensions.html	25 Mar 2003 02:34:12 -0000	1.8
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.8       +23 -1675  xml-site/targets/fop/dev/faq.html
  
  Index: faq.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/faq.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- faq.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ faq.html	25 Mar 2003 02:34:12 -0000	1.8
  @@ -2,7 +2,7 @@
   <html>
   <head>
   <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  -<title>FOP FAQ</title>
  +<title>FOP Developer FAQ</title>
   <link type="text/css" href="../skin/page.css" rel="stylesheet">
   </head>
   <body text="#000000" bgcolor="#FFFFFF">
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  @@ -221,7 +225,7 @@
   <table class="title" summary="">
   <tr>
   <td valign="middle">
  -<h1>FOP FAQ</h1>
  +<h1>FOP Developer FAQ</h1>
   </td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="faq.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
             PDF</a></td>
   </tr>
  @@ -231,1702 +235,46 @@
   <div style="margin-left: 0 ; border: 2px">
   <ul>
   <li>
  -<a name="part-N10005-menu"></a><a href="#part-N10005">1. General questions</a>
  -<ul>
  -<li>
  -<a name="faq-N1000A-menu"></a><a href="#faq-N1000A">What is FOP?</a>
  -</li>
  -<li>
  -<a name="faq-N1001D-menu"></a><a href="#faq-N1001D">What can I do with FOP?</a>
  -</li>
  -<li>
  -<a name="faq-N1002F-menu"></a><a href="#faq-N1002F">What does "FOP" stand for?</a>
  -</li>
  -<li>
  -<a name="faq-N10044-menu"></a><a href="#faq-N10044">How does FOP interact with other Apache Projects?</a>
  -</li>
  -<li>
  -<a name="faq-N1005F-menu"></a><a href="#faq-N1005F">What is XSL?</a>
  -</li>
  -<li>
  -<a name="XSLFO-menu"></a><a href="#XSLFO">What is XSLFO?</a>
  -</li>
  -<li>
  -<a name="XSLT-menu"></a><a href="#XSLT">What is XSLT?</a>
  -</li>
  -<li>
  -<a name="faq-N100AC-menu"></a><a href="#faq-N100AC">How can I contribute?</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N100C1-menu"></a><a href="#part-N100C1">2. Common stumbling blocks</a>
  -<ul>
  -<li>
  -<a name="faq-N100C6-menu"></a><a href="#faq-N100C6">I get the error: [ERROR]: 'master-reference' for
  -      'fo:page-sequence'matches no 'simple-page-master' or
  -      'page-sequence-master'</a>
  -</li>
  -<li>
  -<a name="faq-N100DD-menu"></a><a href="#faq-N100DD">My PNG images don't work.</a>
  -</li>
  -<li>
  -<a name="faq-N100ED-menu"></a><a href="#faq-N100ED">I get a NoClassDefFound exception.</a>
  -</li>
  -<li>
  -<a name="faq-N10108-menu"></a><a href="#faq-N10108">I get a NoSuchMethodException or a NoSuchFieldException
  -      exception.</a>
  -</li>
  -<li>
  -<a name="faq-N10117-menu"></a><a href="#faq-N10117">I get an OutOfMemoryException.</a>
  -</li>
  -<li>
  -<a name="faq-N10140-menu"></a><a href="#faq-N10140">I get a MalformedURLException.</a>
  -</li>
  -<li>
  -<a name="faq-N10177-menu"></a><a href="#faq-N10177">I get an "[ERROR]: null", or a NullPointerException.</a>
  -</li>
  -<li>
  -<a name="faq-N1018C-menu"></a><a href="#faq-N1018C">FOP hangs. FOP does not exit.</a>
  -</li>
  -<li>
  -<a name="boxoverflow-menu"></a><a href="#boxoverflow">FOP runs forever, writing lots of "&gt;" to the log.</a>
  -</li>
  -<li>
  -<a name="faq-N101B3-menu"></a><a href="#faq-N101B3">FOP cannot find a file for fo:external-graphics.</a>
  -</li>
  -<li>
  -<a name="faq-N101C5-menu"></a><a href="#faq-N101C5">FOP does not find my fonts.</a>
  -</li>
  -<li>
  -<a name="faq-N101D4-menu"></a><a href="#faq-N101D4">Keep-with-next, keep-with-previous, keep-together
  -      don't work.</a>
  -</li>
  -<li>
  -<a name="faq-N101EA-menu"></a><a href="#faq-N101EA">My tables are missing, or missing their content.</a>
  -</li>
  -<li>
  -<a name="faq-N101F9-menu"></a><a href="#faq-N101F9">Text overflowing table cells and the like is not clipped. Long text
  -        flows into adjacent cells/block, obscuring stuff there.</a>
  -</li>
  -<li>
  -<a name="faq-N1021F-menu"></a><a href="#faq-N1021F">Page numbers are not properly right aligned.</a>
  -</li>
  -<li>
  -<a name="faq-N1022E-menu"></a><a href="#faq-N1022E">A graphic is not displayed.</a>
  -</li>
  -<li>
  -<a name="faq-N10249-menu"></a><a href="#faq-N10249">Hyphenation does not work.</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N10256-menu"></a><a href="#part-N10256">3. Embedding FOP. Using FOP in a servlet</a>
  +<a name="part_documentation-menu"></a><a href="#part_documentation">1. Documentation</a>
   <ul>
   <li>
  -<a name="faq-N1025B-menu"></a><a href="#faq-N1025B">How do I use FOP in a servlet?</a>
  -</li>
  -<li>
  -<a name="faq-N10274-menu"></a><a href="#faq-N10274">How do I use FOP in a servlet with an XSLT transformation?</a>
  -</li>
  -<li>
  -<a name="faq-N102A3-menu"></a><a href="#faq-N102A3">How do I pass parameters to the XSLT transformation?</a>
  -</li>
  -<li>
  -<a name="faq-N102AF-menu"></a><a href="#faq-N102AF">How do I use my own fonts when running FOP from a servlet?</a>
  -</li>
  -<li>
  -<a name="faq-N102C2-menu"></a><a href="#faq-N102C2">How do I set the base URL in a servlet environment?</a>
  -</li>
  -<li>
  -<a name="faq-N102D1-menu"></a><a href="#faq-N102D1">I keep getting NoClassDefFound and other exceptions. How do I
  -        get FOP working for various servlet engines?</a>
  -</li>
  -<li>
  -<a name="faq-N102E3-menu"></a><a href="#faq-N102E3">FOP in IBM Websphere 3.5</a>
  -</li>
  -<li>
  -<a name="faq-N102EF-menu"></a><a href="#faq-N102EF">FOP and multithreading</a>
  +<a name="javadoc_location-menu"></a><a href="#javadoc_location">How do I get the javadocs for FOP?</a>
   </li>
   </ul>
   </li>
   <li>
  -<a name="part-N102FF-menu"></a><a href="#part-N102FF">4. Batik/SVG specific questions</a>
  +<a name="part_further_help-menu"></a><a href="#part_further_help">2. Further Help</a>
   <ul>
   <li>
  -<a name="faq-N10304-menu"></a><a href="#faq-N10304">SVG text rendered in bad quality. How do I put SVG text as text
  -      into PDF?</a>
  -</li>
  -<li>
  -<a name="faq-N10314-menu"></a><a href="#faq-N10314">How do I use FOP with SVG on headless servers?</a>
  -</li>
  -<li>
  -<a name="svghangs-menu"></a><a href="#svghangs">FOP does not exit if a SVG is included.</a>
  -</li>
  -<li>
  -<a name="faq-N10340-menu"></a><a href="#faq-N10340">Problems with SVG referring to gradients etc. using
  -        "uri(#stuff)" (MalformedURLException or stuff not found)</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N10371-menu"></a><a href="#part-N10371">5. PDF specific (includes Acrobat peculiarities)</a>
  -<ul>
  -<li>
  -<a name="faq-N10376-menu"></a><a href="#faq-N10376">How do I embed fonts in PDF?</a>
  -</li>
  -<li>
  -<a name="faq-N10386-menu"></a><a href="#faq-N10386">Characters not displayed, or displayed incorrectly, or displayed  as "#"</a>
  -</li>
  -<li>
  -<a name="faq-N103A3-menu"></a><a href="#faq-N103A3">PDF encryption, PDF protection (read-only)</a>
  -</li>
  -<li>
  -<a name="faq-N103AF-menu"></a><a href="#faq-N103AF">Watermarks</a>
  -</li>
  -<li>
  -<a name="faq-N103BE-menu"></a><a href="#faq-N103BE">PDF prints contorted</a>
  -</li>
  -<li>
  -<a name="faq-N103CA-menu"></a><a href="#faq-N103CA">Controlling Acrobat bookmark display</a>
  -</li>
  -<li>
  -<a name="faq-N103D6-menu"></a><a href="#faq-N103D6">PDF (more precise: Acrobat Reader) and IEx</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N103E3-menu"></a><a href="#part-N103E3">6. IEx specific stuff</a>
  -<ul>
  -<li>
  -<a name="faq-N103E8-menu"></a><a href="#faq-N103E8">The FOP servlet is called multiple times.</a>
  -</li>
  -<li>
  -<a name="faq-N1040C-menu"></a><a href="#faq-N1040C">How do I print PDF directly from the browser?</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N10422-menu"></a><a href="#part-N10422">7. More general questions regarding XSLT and XSLFO and basic XML</a>
  -<ul>
  -<li>
  -<a name="faq-N10427-menu"></a><a href="#faq-N10427">(FO) How do I vertically center an image or a table (or
  -      whatever)?</a>
  -</li>
  -<li>
  -<a name="faq-N10437-menu"></a><a href="#faq-N10437">(FO) How to get page numbers printed on the "outer side" of the
  -        page (for books, obviously)?</a>
  -</li>
  -<li>
  -<a name="faq-N10447-menu"></a><a href="#faq-N10447">(FO) How do I get a special header on the first page?</a>
  -</li>
  -<li>
  -<a name="oddeven-menu"></a><a href="#oddeven">(FO) Different static content for odd/even pages</a>
  -</li>
  -<li>
  -<a name="faq-N1046B-menu"></a><a href="#faq-N1046B">(FO) How do I omit my headers on a blank page? How do I write
  -      "This page is left blank" on an intentionally blank page?</a>
  -</li>
  -<li>
  -<a name="faq-N10481-menu"></a><a href="#faq-N10481">(FO) How to get Euro sign/checkbox/some other stuff</a>
  -</li>
  -<li>
  -<a name="faq-N1049F-menu"></a><a href="#faq-N1049F">(FO) How do I keep linebreaks/hard spaces? How do I get
  -        preformatted text displayed as expected.</a>
  -</li>
  -<li>
  -<a name="faq-N104B3-menu"></a><a href="#faq-N104B3">(FO) How do I print the total number of pages, like in "page 1
  -      of 12"</a>
  -</li>
  -<li>
  -<a name="faq-N104E3-menu"></a><a href="#faq-N104E3">(FO) The header overlaps body content. The body extends into
  -      footer.</a>
  -</li>
  -<li>
  -<a name="faq-N104F5-menu"></a><a href="#faq-N104F5">(FO) How do I get lines in the document, as separators, side
  -      bars or folding marks?</a>
  -</li>
  -<li>
  -<a name="faq-N10511-menu"></a><a href="#faq-N10511">(XML) Complaints about &amp;nbsp;. How do I get a non-breaking
  -      space in FO?</a>
  -</li>
  -<li>
  -<a name="faq-N1051D-menu"></a><a href="#faq-N1051D">(XML) There are complaints about undefined entities, for example
  -      complaints about &amp;uuml; which used to work in HTML. How do I enter
  -      special characters like in HTML?</a>
  -</li>
  -<li>
  -<a name="faq-N1052D-menu"></a><a href="#faq-N1052D">(XML) There are complaints about illegal characters and entities
  -      in the input.</a>
  -</li>
  -<li>
  -<a name="faq-N10543-menu"></a><a href="#faq-N10543">(XML) There are complaints about illegal bytes or characters in
  -      the input. There are odd characters in the result.</a>
  -</li>
  -</ul>
  -</li>
  -<li>
  -<a name="part-N10554-menu"></a><a href="#part-N10554">8. General suggestions. How to solve problems</a>
  -<ul>
  -<li>
  -<a name="faq-N10559-menu"></a><a href="#faq-N10559">Where to post bugs</a>
  -</li>
  -<li>
  -<a name="postquestions-menu"></a><a href="#postquestions">Where to post questions.</a>
  +<a name="other_faqs-menu"></a><a href="#other_faqs">I don't see my question addressed here. Are there other FAQs?</a>
   </li>
   </ul>
   </li>
   </ul>
   </div>
  -<a name="N10171"></a>
  +<a name="N10021"></a>
   <h3>Answers</h3>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10174"></a><a name="part-N10005"></a>
  -<h4>1. General questions</h4>
  +<a name="N10024"></a><a name="part_documentation"></a>
  +<h4>1. Documentation</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10178"></a><a name="faq-N1000A"></a>
  -<h5>1.1. What is FOP?<span style="float: right"><a href="#faq-N1000A-menu">^</a></span>
  +<a name="N10028"></a><a name="javadoc_location"></a>
  +<h5>1.1. How do I get the javadocs for FOP?<span style="float: right"><a href="#javadoc_location-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  -<p>
  -        FOP is a print formatter for <a target="_top" href="#XSLFO">XSL formatting
  -        objects</a>.
  -      </p>
  -<p>
  -        It can be used to render an XML file containing XSL formatting objects
  -        into a page layout. The main target is PDF but other rendering targets
  -        are supported, such as AWT, PCL, text and direct printing.
  -      </p>
  -</div>
  -<a name="N10187"></a><a name="faq-N1001D"></a>
  -<h5>1.2. What can I do with FOP?<span style="float: right"><a href="#faq-N1001D-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          FOP provides both an application and a library that converts an XSL FO
  -          document into paginated output.
  -        </p>
  -<p>
  -          The FOP command line application can be directly used to transform XML
  -          into PDF, PostScript, PCL and other formats, there is also an AWT
  -          based viewer integrated.
  -        </p>
  -<p>
  -          The library can be used in servlets and other Java applications.
  -        </p>
  -</div>
  -<a name="N10195"></a><a name="faq-N1002F"></a>
  -<h5>1.3. What does "FOP" stand for?<span style="float: right"><a href="#faq-N1002F-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          It's an acronym for <strong>F</strong>ormatting
  -          <strong>O</strong>bject <strong>P</strong>rocessor
  -        </p>
  -</div>
  -<a name="N101A6"></a><a name="faq-N10044"></a>
  -<h5>1.4. How does FOP interact with other Apache Projects?<span style="float: right"><a href="#faq-N10044-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          FOP is distributed with <a href="http://xml.apache.org/cocoon">Cocoon</a> as a PDF serializer
  -          for XSL (FO) documents.
  -        </p>
  -<p>
  -          
  -<a href="http://xml.apache.org/batik">Batik</a> can be used with
  -          FOP to <a href="http://xml.apache.org/batik/svgrasterizer.html">transcode an SVG
  -          image</a> into a PDF document.
  -        </p>
  -</div>
  -<a name="N101BD"></a><a name="faq-N1005F"></a>
  -<h5>1.5. What is XSL?<span style="float: right"><a href="#faq-N1005F-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          XSL is a W3C standard concerned with publishing XML documents. It
  -          consists of two parts: <a target="_top" href="#XSLT">XSLT</a> and <a target="_top" href="#XSLFO">XSLFO</a>. The acronym expands to
  -          e<strong>X</strong>tensible <strong>S</strong>tylesheet
  -          <strong>L</strong>anguage.
  -        </p>
  -</div>
  -<a name="N101D6"></a><a name="XSLFO"></a>
  -<h5>1.6. What is XSLFO?<span style="float: right"><a href="#XSLFO-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          XSLFO is an XML vocabulary that is used to specify a pagination and
  -          other styling for page layout output. The acronym &ldquo;FO&rdquo; stands for
  -          <strong>F</strong>ormatting <strong>O</strong>bjects. XSLFO can be
  -          used in conjunction with <a target="_top" href="#XSLT">XSLT</a> to convert
  -          from any XML format into a paginated layout ready for printing or
  -          displaying.
  -        </p>
  -<p>
  -          XSLFO defines a set of elements in XML that describes the way pages
  -          are set up. The contents of the pages are filled from flows. There can
  -          be static flows that appear on every page (for headers and footers)
  -          and the main flow which fills the body of the page.
  -        </p>
  -<p>
  -          Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects
  -        </p>
  -</div>
  -<a name="N101EE"></a><a name="XSLT"></a>
  -<h5>1.7. What is XSLT?<span style="float: right"><a href="#XSLT-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          XSLT describes the transformation of arbitrary XML input into other
  -          XML (like XSLFO), HTML or plain text. The &ldquo;T&rdquo; comes from
  -          <strong>T</strong>ransformation. For historical reasons, a
  -          transformation is often also called a &ldquo;style sheet&rdquo;.
  -        </p>
  -<p>
  -          Synonyms: XSL transformation, XSL:T, XSL style sheet.
  -        </p>
  -</div>
  -<a name="N101FC"></a><a name="faq-N100AC"></a>
  -<h5>1.8. How can I contribute?<span style="float: right"><a href="#faq-N100AC-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          There is always plenty of things to do. See <a href="../limitations.html">limitations</a>
  -          and <a href="../resources.html">bugzilla</a>.
  -        </p>
  +<p>Currently, the only way to get FOP javadocs is to <a href="../download.html">
  +        Download the source code</a> and then <a href="../compiling.html">Build
  +        FOP</a> using the ant build task "javadocs".</p>
   </div>
   </div>
  -<a name="N1020C"></a><a name="part-N100C1"></a>
  -<h4>2. Common stumbling blocks</h4>
  +<a name="N10038"></a><a name="part_further_help"></a>
  +<h4>2. Further Help</h4>
   <div style="margin-left: 0 ; border: 2px">
  -<a name="N10210"></a><a name="faq-N100C6"></a>
  -<h5>2.1. I get the error: [ERROR]: 'master-reference' for
  -      'fo:page-sequence'matches no 'simple-page-master' or
  -      'page-sequence-master'<span style="float: right"><a href="#faq-N100C6-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          FOP was changed to be in accordance with the latest standard
  -          (see <a href="../resources.html#w3-xsl">XSL
  -          standard</a>).The page master for a fo:page-sequence is
  -          now refereced by the master-reference attribute. Replace the
  -          master-name attributes of your fo:page-sequence elements by
  -          master-reference attributes. You have to do this also for
  -          fo:single-page-master-reference,
  -          fo:repeatable-page-master-reference and
  -          fo:conditional-page-master-reference elements in you page
  -          master definitions.
  -        </p>
  -<p>
  -          See also <a href="../relnotes.html">release notes</a>.
  -        </p>
  -</div>
  -<a name="N10223"></a><a name="faq-N100DD"></a>
  -<h5>2.2. My PNG images don't work.<span style="float: right"><a href="#faq-N100DD-menu">^</a></span>
  +<a name="N1003C"></a><a name="other_faqs"></a>
  +<h5>2.1. I don't see my question addressed here. Are there other FAQs?<span style="float: right"><a href="#other_faqs-menu">^</a></span>
   </h5>
   <div style="margin-left: 15 ; border: 2px">
  -<p>
  -          The Jimi image library, which is used for processing images in PNG and
  -          other formats, was removed from the distribution for licensing
  -          reasons. You have to <a target="_blank" href="http://java.sun.com">download</a>
  -          and install it by yourself.
  -        </p>
  -</div>
  -<a name="N1022F"></a><a name="faq-N100ED"></a>
  -<h5>2.3. I get a NoClassDefFound exception.<span style="float: right"><a href="#faq-N100ED-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>This is typically a problem with your classpath.</p>
  -<p>If you are running FOP from the command line:</p>
  -<ul>
  -          
  -<li>
  -            Use the fop.bat or fop.sh command file from the FOP distribution.
  -            Ensure the directory where FOP and these files have been installed
  -            is the current working directory.
  -          </li>
  -          
  -<li>
  -            If this doesn't help, check whether still all the jar files
  -            mentioned in the classpath in the fop.bat file are in their
  -            respective places.
  -          </li>
  -        
  -</ul>
  -<p>
  -          If you run FOP embedded in your servlet, web application or other Java
  -          application, check the classpath of the application.
  -        </p>
  -</div>
  -<a name="N10246"></a><a name="faq-N10108"></a>
  -<h5>2.4. I get a NoSuchMethodException or a NoSuchFieldException
  -      exception.<span style="float: right"><a href="#faq-N10108-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          This is usually caused by an older version of one of the FOP jars or
  -          old XML tools in the classpath. Check in particular for parser.jar,
  -          jaxp.jar, xml4j.jar or lotusxsl.jar.
  -        </p>
  -<p>
  -          Incompatible versions of Batik may also cause this problem. Use
  -          the version of Batik that comes with FOP.
  -        </p>
  -</div>
  -<a name="N10251"></a><a name="faq-N10117"></a>
  -<h5>2.5. I get an OutOfMemoryException.<span style="float: right"><a href="#faq-N10117-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          FOP can consume quite a bit of memory, even though this has been
  -          continually improved. The memory consumption is partially inherent to
  -          the formatting process and partially caused by implementation
  -          choices. For certain layouts, all FO processors currently on the
  -          market have memory problems.
  -        </p>
  -<p>
  -          Some hints regarding your document structure:
  -        </p>
  -<ul>
  -          
  -<li>
  -            Avoid forward references. Forward references cause all
  -            pages from the page with the reference on to be held in memory until
  -            the page with the referenced element is encountered. Common forward
  -            references are table of contents at the beginning of the document
  -            and the <a href="#pagenum">"page N of TOTAL"</a> in footers. Forward
  -            references may be required by the task, however, if you are getting
  -            a memory overflow you should at least check whether this is really
  -            as necessary as claimed. A TOC, for example, could often be placed
  -            at the end of the document without dimishing it's value too much,
  -            the paper can be reshuffled after printing, and you can use
  -            bookmarks in PDF.
  -          </li>
  -          
  -<li>
  -            Avoid large images, especially if they are scaled down. Scale them
  -            outside of FOP and use the already scaled images for the FOP
  -            run. For many image formats it is mainly the size of the image file
  -            which matters, not width*height, so you can try other means like
  -            using a higher compression rate.
  -          </li>
  -          
  -<li>
  -            Use multiple page sequences. FOP starts rendering after the end of a
  -            page sequence is encountered. While the actual rendering is done
  -            page by page, some memory allocated for other purposes could
  -            possibly be freed after the page sequence has been rendered.
  -          </li>
  -          
  -<li>
  -            Increase memory settings of the JVM. Be aware that it
  -            is usually unwise to increase the memory allocated to the JVM beyond
  -            the amount of physical RAM, it will significantly slow down. YMMV.
  -          </li>
  -        
  -</ul>
  -<p>
  -          There are also some bugs which cause FOP to go into an nonterminating
  -          loop, which also often results in a memory overflow. A characteristic
  -          symptom are continuous <a target="_top" href="#boxoverflow">box
  -          overflows</a>. Most of them are triggered by elements not fitting
  -          in the available space, like big images and improperly specified width
  -          of nested block elements. Look for such stuff and correct it.
  -        </p>
  -</div>
  -<a name="N10276"></a><a name="faq-N10140"></a>
  -<h5>2.6. I get a MalformedURLException.<span style="float: right"><a href="#faq-N10140-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<a name="MalformedURL"></a>
  -<p>
  -          What you probably think of as "file names" are usually URLs, in
  -          particular the src attribute of fo:external-graphic.
  -        </p>
  -<p>
  -          Because usage of URLs is growing, you should make yourself familiar
  -          with it. The relevant specification is <a href="http://www.rfc-editor.org/rfc/rfc2396.txt">RFC 2396</a>.
  -        </p>
  -<p>
  -          In a nutshell, the correct syntax for an absolute file URL is
  -          <span class="codefrag">file:///some/path/file.ext</span> on Unix and
  -          <span class="codefrag">file:///z:/some/path/file.ext</span> on Windows systems. Note
  -          the triple slash, and also that only forward slashes are used, even on
  -          windows.
  -        </p>
  -<p>
  -          A relative file URL starts with anything but a slash, and doesn't have
  -          the <span class="codefrag">file:</span> prefix, for example <span class="codefrag">file.ext</span>,
  -          <span class="codefrag">path/file.ext</span> or <span class="codefrag">../file.ext</span>. The string
  -          <span class="codefrag">file:path/file.ext</span> is <em>not</em> a relative URL,
  -          in fact, it isn't a valid URL at all. A relative URL is subject to a
  -          resolving process, which transforms it into an absolute
  -          URL.
  -        </p>
  -<p>
  -          See Understanding URIs and URLs and Understanding
  -          URL resolving.
  -        </p>
  -</div>
  -<a name="N102A9"></a><a name="faq-N10177"></a>
  -<h5>2.7. I get an "[ERROR]: null", or a NullPointerException.<span style="float: right"><a href="#faq-N10177-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Most often, you supplied an invalid FO document to FOP. Currently only
  -          very common errors are intercepted and produce a comprehensible error
  -          message. If you forgot container elements like fo:page-sequence or
  -          fo:flow and put blocks and inline elements directly as children of
  -          fo:root or fo:page-sequence, you'll only get a
  -          NullPointerException. Check whether your FO file has a proper
  -          structure. In some cases there are mandatory properties, like the
  -          master-reference in fo:conditional-page-master-reference, check also
  -          whether you got them right.
  -        </p>
  -<p>
  -          You can use the FOP DTD or FOP Schema to
  -          validate your soure. This will catch most, but still not all problems.
  -        </p>
  -<p>
  -          If you use XSLT, problems in your style sheet and in your source XML
  -          also often produce a NullPointerException. Run the transformation
  -          separately to check for this, usually you'll get a detailed error
  -          message from the XSLT processor.
  -        </p>
  -<p>
  -          If you turn on debugging with the "-d" option you may be able to
  -          see more detailed information.
  -        </p>
  -</div>
  -<a name="N102BA"></a><a name="faq-N1018C"></a>
  -<h5>2.8. FOP hangs. FOP does not exit.<span style="float: right"><a href="#faq-N1018C-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          The most likely reason is a known problem with the Java run time
  -          environment which is triggered by rendering SVGs. Suns JDK 1.4 does
  -          not have this problem. See also <a target="_top" href="#svghangs">FOP does not
  -          exit if a SVG is included</a>.
  -        </p>
  -<p>
  -          Another possibility is that FOP went into a non terminating
  -          loop. Usually this is indicated by lots of log messages of the form
  -          "[INFO]: [NNNN]" which indicate a new page has been started or <a target="_top" href="#boxoverflow">box overflows</a>. After some time, FOP will
  -          crash with an OutOfMemoryException.
  -        </p>
  -<p>
  -          If you called the FOP command line application from some other
  -          programm, for example from Java using Runtime.exec(), it may hang
  -          while trying to write log entries to the output pipe. You have to read
  -          the FOP output regularly to empty the pipe buffer. It is best to avoid
  -          exec'ing FOP, use the library interface.
  -        </p>
  -</div>
  -<a name="N102D0"></a><a name="boxoverflow"></a>
  -<h5>2.9. FOP runs forever, writing lots of "&gt;" to the log.<span style="float: right"><a href="#boxoverflow-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          There is something too large to fit into the intended place, usually a
  -          large image, a table whose rows are kept together or a block with a
  -          space-before or space-after larger than the page size. Catch the first
  -          page showing this phenomenon and check it. If it is not obvious which
  -          element causes the trouble, remove stuff until the problem goes
  -          away. Decrease the dimensions of the offending element or property, or
  -          increase the dimension of the enclosing element or container, or
  -          remove keep-with-* properties.
  -        </p>
  -</div>
  -<a name="N102D8"></a><a name="faq-N101B3"></a>
  -<h5>2.10. FOP cannot find a file for fo:external-graphics.<span style="float: right"><a href="#faq-N101B3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          The src attribute of the fo:external-graphics element takes an URI,
  -          not a file name.
  -        </p>
  -<p>
  -          Relative URLs are resolved against a base url. For
  -          the command line FOP application, the base is the directory of the
  -          input file, either the FO file or the XML source. If FOP is used
  -          embedded in a servlet you will need to set the base url on
  -          the user agent.
  -        </p>
  -<p>
  -          See Understanding URIs and URLs and Understanding
  -          URL resolving.
  -        </p>
  -</div>
  -<a name="N102E6"></a><a name="faq-N101C5"></a>
  -<h5>2.11. FOP does not find my fonts.<span style="float: right"><a href="#faq-N101C5-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Did you get: &lsaquo;Failed to read font metrics file C:\foo\arial.xml
  -          : File "C:\foo\arial.xml" not found&rsaquo;? The value for the
  -          metrics-file attribute in the user config file is actually an URL, not
  -          a file name. Use "file:///C:/foo/arial.xml" instead.
  -        </p>
  -<p>
  -          If you used a relative URL, make sure your application has the working
  -          directory you expect. Currently FOP does not use the baseDir for
  -          resolving relative URLs pointing to font metric files.
  -        </p>
  -</div>
  -<a name="N102F1"></a><a name="faq-N101D4"></a>
  -<h5>2.12. Keep-with-next, keep-with-previous, keep-together
  -      don't work.<span style="float: right"><a href="#faq-N101D4-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          These properties are not implemented, except for keep-with-next and
  -          keep-with-previous on table rows. In order to take advantage of them,
  -          you have to nest stuff to be kept together in a table.
  -        </p>
  -<p>
  -          The concept is called &ldquo;blind table&rdquo;. The table is used for
  -          pure layout reasons and not obvious in the output.
  -        </p>
  -<p>
  -          An example of an image and the image caption to be kept together:
  -        </p>
  -<pre class="code">&lt;fo:table table-layout="fixed" width="100%"&gt;
  -  &lt;fo:table-column column-width="proportional-column-width(1)"/&gt;
  -    &lt;fo:table-body&gt;
  -      &lt;fo:table-row keep-with-next="always"&gt;
  -        &lt;fo:table-cell&gt;
  -          &lt;fo:block&gt;
  -            &lt;fo:external-graphic src="foo.jpg"/&gt;
  -          &lt;/fo:block&gt;
  -        &lt;/fo:table-cell&gt;
  -      &lt;/fo:table-row&gt;
  -      &lt;fo:table-row&gt;
  -        &lt;fo:table-cell&gt;
  -          &lt;fo:block&gt;Image Caption&lt;/fo:block&gt;
  -        &lt;/fo:table-cell&gt;
  -      &lt;/fo:table-row&gt;
  -    &lt;/fo:table-body&gt;
  -  &lt;/fo:table&gt;</pre>
  -</div>
  -<a name="N10303"></a><a name="faq-N101EA"></a>
  -<h5>2.13. My tables are missing, or missing their content.<span style="float: right"><a href="#faq-N101EA-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Check for fo:table-body around the rows. FOP doesn't raise an error if
  -          it is omitted, it just drops the content.
  -        </p>
  -<p>
  -          Also, the fo:table-with-caption element is not implemented, tables
  -          within such an element are dropped too. The DocBook style sheets
  -          generate fo:table-with-caption elements, so watch out.
  -        </p>
  -</div>
  -<a name="N1030E"></a><a name="faq-N101F9"></a>
  -<h5>2.14. Text overflowing table cells and the like is not clipped. Long text
  -        flows into adjacent cells/block, obscuring stuff there.<span style="float: right"><a href="#faq-N101F9-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Clipping as specified by the <span class="codefrag">overflow="hidden"</span> is not yet
  -          implemented.  If you have long words overflowing table cells, try to
  -          get them hyphenated. Artificial names like product identifications or
  -          long numbers usually aren't hyphenated. You can try special processing
  -          at XSLT level, like
  -        </p>
  -<ul>
  -          
  -<li>
  -            clip long text,
  -          </li>
  -          
  -<li>
  -            explicit wrapping+clipping,
  -          </li>
  -          
  -<li>
  -            insert zero width spaces (U+200B or &amp;#x200B;) to allow FOP to
  -            wrap.
  -          </li>
  -        
  -</ul>
  -<p>
  -          Check the <a href="http://dpawson.co.uk/xsl">XSL FAQ</a> and the
  -          <a href="http://www.mulberrytech.com/xsl/xsl-list/">XSL list
  -          archive</a> for how to perform these tasks.
  -        </p>
  -</div>
  -<a name="N10330"></a><a name="faq-N1021F"></a>
  -<h5>2.15. Page numbers are not properly right aligned.<span style="float: right"><a href="#faq-N1021F-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          This happens for fo:page-number-citation elements if the citation
  -          occurs before FOP formatted the requested page, usually in TOC or
  -          index pages.
  -        </p>
  -<p>
  -          It is caused by the problem that FOP has to guess how much space the
  -          yet unknown page number will occupy, and usually the guesses are
  -          somewhat off. You can try to use a non-proportional font like Courier
  -          to remedy this. However, this is likely to look ugly, and wont fix the
  -          problem completely.
  -        </p>
  -</div>
  -<a name="N1033B"></a><a name="faq-N1022E"></a>
  -<h5>2.16. A graphic is not displayed.<span style="float: right"><a href="#faq-N1022E-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Several possibilities:
  -        </p>
  -<ul>
  -          
  -<li>
  -            The graphic is too large to fit into the intended space.
  -          </li>
  -          
  -<li>
  -            Some image format subclasses can't be handled, try to convert the
  -            graphic to a format subclass known to work. (Sorry, no list of
  -            formats known to work)
  -          </li>
  -          
  -<li>
  -            Something else obscures the graphic, for example stuff from a static
  -            content (very rare, but has happened).
  -          </li>
  -        
  -</ul>
  -<p>
  -          See also supported image formats.
  -        </p>
  -</div>
  -<a name="N10352"></a><a name="faq-N10249"></a>
  -<h5>2.17. Hyphenation does not work.<span style="float: right"><a href="#faq-N10249-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Set the language attribute somewhere. Check whether you use a language
  -          for which hyphenation is supported. Supported languages can be deduced
  -          from the files in the hyph directory of the FOP source distribution.
  -        </p>
  -</div>
  -</div>
  -<a name="N1035A"></a><a name="part-N10256"></a>
  -<h4>3. Embedding FOP. Using FOP in a servlet</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N1035E"></a><a name="faq-N1025B"></a>
  -<h5>3.1. How do I use FOP in a servlet?<span style="float: right"><a href="#faq-N1025B-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>Look at the servlet example.</p>
  -<p>
  -          A rather minimal code snippet to demonstrate the basics:
  -        </p>
  -<pre class="code">response.setContentType("application/pdf");
  -Driver driver=new Driver( new InputSource("foo.fo"),
  -                          response.getOutputStream());
  -driver.setRenderer(Driver.RENDER_PDF);
  -driver.run();</pre>
  -<p>
  -          Caveat: Internet Explorer will not automatically show the PDF. Thats a
  -          well known IEx problem, not with the servlet. You can download the PDF
  -          with IEx and view it later. There are other problems with this code.
  -        </p>
  -<p>
  -          Please look into Howto embed FOP in a servlet for all
  -          kinds of details.
  -        </p>
  -</div>
  -<a name="N10373"></a><a name="faq-N10274"></a>
  -<h5>3.2. How do I use FOP in a servlet with an XSLT transformation?<span style="float: right"><a href="#faq-N10274-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Use the TraxInputHandler if both the source XML and XSL are read from
  -          files.
  -        </p>
  -<p>
  -          A demonstration:
  -        </p>
  -<pre class="code">response.setContentType("application/pdf");
  -XSLTInputHandler input
  -  =new XSLTInputHandler(new File("foo.xml"), new File("foo.xsl"));
  -Driver driver=new Driver();
  -driver.setOutputStream(response.getOutputStream());
  -driver.setRenderer(Driver.RENDER_PDF);
  -driver.render(input.getParser(), input.getInputSource());</pre>
  -<p>
  -          This minimal code snippet has the same problems as the one from the
  -          question above. Please inform yourself about the details.
  -        </p>
  -<p>
  -          If your source XML is generated on the fly, for example from a
  -          database, a web service, or another servlet, you have to create a
  -          transformer object explicitely and use a SAX event stream to feed the
  -          transformation result into FOP.
  -        </p>
  -<p>
  -          A demonstration:
  -        </p>
  -<pre class="code">response.setContentType("application/pdf");
  -Driver driver =new Driver();
  -driver.setOutputStream(response.getOutputStream());
  -driver.setRenderer(Driver.RENDER_PDF);
  -Transformer transformer=TransformerFactory.newInstance()
  -        .newTransformer(new StreamSource("foo.xsl"));
  -transformer.transform(xmlsource, new SAXResult(driver.getContentHandler()));</pre>
  -<p>
  -         You don't have to call run() or render() on the driver object.
  -        </p>
  -<p>
  -          The <span class="codefrag">xmlsource</span> is a placeholder for your actual XML
  -          source. You can supply a <span class="codefrag">new StreamSource( new
  -          StringReader(xmlstring))</span> if you have to read the XML from a
  -          string. Constructing an XML string and reparse it is not always a good
  -          iea, consider to use a SAXSource if you generate your XML. You can, of
  -          course, supply a DOMSource or whatever you like. You can also use
  -          dynamically generated XSL if you want to.
  -        </p>
  -<p>
  -          Because you have an explicit transformer object, you can set
  -          parameters for the transformation run too.
  -        </p>
  -</div>
  -<a name="N1039E"></a><a name="faq-N102A3"></a>
  -<h5>3.3. How do I pass parameters to the XSLT transformation?<span style="float: right"><a href="#faq-N102A3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          See the end of the answer for the question above.
  -        </p>
  -</div>
  -<a name="N103A6"></a><a name="faq-N102AF"></a>
  -<h5>3.4. How do I use my own fonts when running FOP from a servlet?<span style="float: right"><a href="#faq-N102AF-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Declare the fonts in the <span class="codefrag">userconfig.xml</span> file as
  -          usual. See <a target="_top" href="#usercfg">loading the user configuration
  -          file</a> for further steps.
  -        </p>
  -</div>
  -<a name="N103B5"></a><a name="faq-N102C2"></a>
  -<h5>3.5. How do I set the base URL in a servlet environment?<span style="float: right"><a href="#faq-N102C2-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Use:
  -        </p>
  -<p>
  -          You need to use the FOUserAgent that contains a base url.
  -        </p>
  -</div>
  -<a name="N103C0"></a><a name="faq-N102D1"></a>
  -<h5>3.6. I keep getting NoClassDefFound and other exceptions. How do I
  -        get FOP working for various servlet engines?<span style="float: right"><a href="#faq-N102D1-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          There are various classpath issues, and possible conflicts with
  -          existing XML/XSLT libraries. Because servlet containers often use
  -          their own classloaders for loading webapps, bugs and security problems
  -          can be bothersome as well.
  -        </p>
  -<p>
  -          Tomcat comes with detailed instructions for installing FOP and Cocoon,
  -          check the documentation. There are known bugs to be circumvented, in
  -          particular in Tomcat 4.0.3.
  -        </p>
  -<p>
  -          Websphere 3.5: See next question.
  -        </p>
  -</div>
  -<a name="N103CE"></a><a name="faq-N102E3"></a>
  -<h5>3.7. FOP in IBM Websphere 3.5<span style="float: right"><a href="#faq-N102E3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Put a copy of a working parser in some directory where WebSphere can
  -          access it, for example, if /usr/webapps/yourapp/servlets is the
  -          classpath for your servlets, copy the Xerces jar into it (any other
  -          directory would also be fine). Do not add the jar to the servlet
  -          classpath, but add it to the classpath of the application server which
  -          contains your web application. In the WebSphere administration
  -          console, click on the "environment" button in the "general" tab. Fill
  -          CLASSPATH in the "variable name" box and
  -          /usr/webapps/yourapp/servlets/Xerces.jar (or whatever your complete
  -          path is) in the value box, press "OK", then apply the change and
  -          restart the application server.
  -        </p>
  -</div>
  -<a name="N103D6"></a><a name="faq-N102EF"></a>
  -<h5>3.8. FOP and multithreading<span style="float: right"><a href="#faq-N102EF-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          FOP is not completely thread safe. At the very least you'll have to
  -          create a Driver object for every thread unless you prefer your threads
  -          being blocked.
  -        </p>
  -<p>
  -          Even though the relevant methods of the Driver object are
  -          synchronized, there are still problems because FOP uses static
  -          variables for configuration data and loading images. Be sure not
  -          to change the configuration data while there is a Driver object
  -          rendering. It is recommended to setup the configuration only
  -          once while initialising the servlet. If you have to change the
  -          configuration data more often, or if you have several servlets
  -          within the same webapp using FOP, consider implementing a
  -          singleton class encapsulating both the configuration settings
  -          and running FOP in synchronized methods.
  -        </p>
  -</div>
  -</div>
  -<a name="N103E1"></a><a name="part-N102FF"></a>
  -<h4>4. Batik/SVG specific questions</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N103E5"></a><a name="faq-N10304"></a>
  -<h5>4.1. SVG text rendered in bad quality. How do I put SVG text as text
  -      into PDF?<span style="float: right"><a href="#faq-N10304-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          There is an implementation of a Batik bridge and text painter
  -          that handles SVG text nodes.
  -          If it is possible for this to draw the text as PDF text in the
  -          PDF document then it will do so otherwise the stroking
  -          text painter is used. There are some cases that are not implemented
  -          yet such as tspan and outlined text. See
  -          <a href="svg.html">SVG page</a> for more details.
  -        </p>
  -</div>
  -<a name="N103F1"></a><a name="faq-N10314"></a>
  -<h5>4.2. How do I use FOP with SVG on headless servers?<span style="float: right"><a href="#faq-N10314-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Batik uses AWT classes for rendering SVG, which in turn needs an X
  -          server on Unixish systems. If you run a server without X, or if you
  -          can't connect to the X server due to security restrictions or
  -          policies, SVG rendering will fail.
  -        </p>
  -<p>
  -          There are still several options:
  -        </p>
  -<ul>
  -          
  -<li>
  -            If you are using JDK 1.4, start it with the -Djava.awt.headless=true
  -            command line option.
  -          </li>
  -          
  -<li>
  -            Install a X server which provides an im-memory framebuffer without
  -            actually using a screen device or any display hardware, like Xvfb.
  -          </li>
  -          
  -<li>
  -            Use a toolkit which emulates AWT without the need of an underlying X
  -            server, like <a href="http://www.eteks.com/pja/en">PJA</a>. The PJA toolkit is
  -            free and comes with detailed installation instructions.
  -          </li>
  -        
  -</ul>
  -</div>
  -<a name="N1040C"></a><a name="svghangs"></a>
  -<h5>4.3. FOP does not exit if a SVG is included.<span style="float: right"><a href="#svghangs-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Applies to older FOP versions and JDK 1.3 and older. That's because
  -          there is an AWT thread hanging around. The solution is to put a
  -          System.exit(0) somewhere.
  -        </p>
  -</div>
  -<a name="N10414"></a><a name="faq-N10340"></a>
  -<h5>4.4. Problems with SVG referring to gradients etc. using
  -        "uri(#stuff)" (MalformedURLException or stuff not found)<span style="float: right"><a href="#faq-N10340-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          This is really a "resolving relative URI" problem with some
  -          twists. The problem is that the <span class="codefrag">#stuff</span> URL fragment
  -          identifier is resolved within the current SVG document. So the
  -          reference must be valid within the XML subset and it cannot
  -          reference other SVG documents in the same XML file. Some options
  -          to try:
  -        </p>
  -<ul>
  -          
  -<li>
  -            Put the SVG into a separate file and use it with
  -            fo:external-graphics.
  -          </li>
  -          
  -<li>
  -            Use a separate SVG file which contains only the gradient (and
  -            perhaps other SVG stuff you want to reference) and point an absolute
  -            URL to it:
  -            <span class="codefrag">fill="url(file:///c:/refstuff/grad.svg#PurpleToWhite)"</span>.
  -          </li>
  -          
  -<li>
  -            Same as above but use a relative URL:
  -            <span class="codefrag">fill="url(grad.svg#PurpleToWhite)"</span>. This may be easier
  -            to deploy.
  -          </li>
  -          
  -<li>
  -            Make sure that the reference is valid in the current SVG document.
  -          </li>
  -        
  -</ul>
  -<p>
  -          In any case, the referenced stuff has to be pointed to by an URL. It
  -          doesn't necessarily have to be a file URL, HTTP should also
  -          work. Also, expect a performance hit in all cases, because another XML
  -          file has to be retrieved and parsed.
  -        </p>
  -<p>
  -          Ultimately, both FOP and especially Batik should be fixed to make
  -          your code work as expected, but this will not only take some time
  -          but also some effort by a standard committee in order to make the
  -          semantics of this kind of references in embedded SVG clearer.
  -        </p>
  -<p>See also <a href="#MalformedURL">MalformedURLException</a>
  -</p>
  -</div>
  -</div>
  -<a name="N10440"></a><a name="part-N10371"></a>
  -<h4>5. PDF specific (includes Acrobat peculiarities)</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N10444"></a><a name="faq-N10376"></a>
  -<h5>5.1. How do I embed fonts in PDF?<span style="float: right"><a href="#faq-N10376-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          See the <a href="fonts.html">Fonts</a> page for information
  -          about embedding fonts.
  -        </p>
  -</div>
  -<a name="N10450"></a><a name="faq-N10386"></a>
  -<h5>5.2. Characters not displayed, or displayed incorrectly, or displayed  as "#"<span style="float: right"><a href="#faq-N10386-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>Answers are that fonts must be available for the output format, and
  -  the selected font must contain glyphs for the desired character.
  -PDF has a set of <a href="output.html#pdf-fonts">defined fonts</a>, other fonts can be embedded following the
  -<a href="fonts.html">instructions</a>.
  -To find out if the characters you need are in the core fonts then
  -(todo - find a glyph font table for the fonts).
  -</p>
  -<p>  For example, for most symbols, the symbol font has to be selected
  -  explicitely (in future it should be possible to specify a list of fonts
  -where it will select the font for the specified character):
  -</p>
  -<p>   &lt;fo:inline font-family="Symbol"&gt;&amp;#x2205;&lt;/fo:inline&gt;</p>
  -<p>  gives EMPTY SET while the same characters in the default font results
  -  in AE LIGATURE (which happens to occupy the same place in the default
  -  font as the EMPTY SET in the Symbol font). The "#" shows up if the
  -  selected font does not define a glyph for the translated index.</p>
  -</div>
  -<a name="N10469"></a><a name="faq-N103A3"></a>
  -<h5>5.3. PDF encryption, PDF protection (read-only)<span style="float: right"><a href="#faq-N103A3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>use some other tool to postprocess the PDF (itext, or something?)</p>
  -</div>
  -<a name="N10471"></a><a name="faq-N103AF"></a>
  -<h5>5.4. Watermarks<span style="float: right"><a href="#faq-N103AF-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>  Answer: see 3.3, or use a a region overlapping the flowing text and put
  -  an image there:
  -</p>
  -<p>   &gt; From: Trevor_Campbell@kaz.com.au
  -    Use the region-before.  Make it large enough to contain your image and then
  -    include a block (and if required an absolutely positioned block-container)
  -    with your image in the static-content for the region-before.
  -  Could use some code here...
  -        </p>
  -</div>
  -<a name="N1047C"></a><a name="faq-N103BE"></a>
  -<h5>5.5. PDF prints contorted<span style="float: right"><a href="#faq-N103BE-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>Check paper size in Acrobat settings and "fit to page" (or something)</p>
  -</div>
  -<a name="N10484"></a><a name="faq-N103CA"></a>
  -<h5>5.6. Controlling Acrobat bookmark display<span style="float: right"><a href="#faq-N103CA-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>  Not possible with FOP. Postprocess the PDF.</p>
  -</div>
  -<a name="N1048C"></a><a name="faq-N103D6"></a>
  -<h5>5.7. PDF (more precise: Acrobat Reader) and IEx<span style="float: right"><a href="#faq-N103D6-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>see #later</p>
  -</div>
  -</div>
  -<a name="N10494"></a><a name="part-N103E3"></a>
  -<h4>6. IEx specific stuff</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N10498"></a><a name="faq-N103E8"></a>
  -<h5>6.1. The FOP servlet is called multiple times.<span style="float: right"><a href="#faq-N103E8-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          This is a problem of Internet Explorer requesting the content several
  -          times. Some suggestions:
  -        </p>
  -<ul>
  -          
  -<li>
  -            Use a URL ending in <span class="codefrag">.pdf</span>, like
  -            <span class="codefrag">http://myserver/servlet/stuff.pdf</span>. Yes, the servlet can
  -            be configured to handle this. If the URL has to contain parameters,
  -            try to have both the base URL as well as the last parameter end in
  -            <span class="codefrag">.pdf</span>, if necessary append a dummy parameter, like
  -            <span class="codefrag">http://myserver/servlet/stuff.pdf?par1=a&amp;par2=b&amp;d=.pdf</span>. The
  -            effect may depend on IEx version.
  -          </li>
  -          
  -<li>
  -            Give IEx the opportunity to cache. In particular, ensure the server
  -            does not set any headers causing IEx not to cache the content. This
  -            may be a real problem if the document is sent over HTTPS. Consult
  -            your server manual.
  -          </li>
  -          
  -<li>
  -            Cache in the server. Including a parameter in the URL which has a
  -            timestamp as the value may help you to decide whether a request is
  -            repeated. IEx is reported to retrieve a document up to three times,
  -            but never more often.
  -          </li>
  -        
  -</ul>
  -</div>
  -<a name="N104B8"></a><a name="faq-N1040C"></a>
  -<h5>6.2. How do I print PDF directly from the browser?<span style="float: right"><a href="#faq-N1040C-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          It depends whether you mean "printing to a printer under control of the
  -          server" or "printing on the client's printer".
  -        </p>
  -<p>
  -          For the first problem, look at the print servlet in the FOP
  -          examples. You'll have to gather any printer settings in an HTML form
  -          and send it to the server.
  -        </p>
  -<p>
  -          For the second task, you can use some client side script to start
  -          Acrobat Reader in print mode, or use a Java applet based on the FOP
  -          print servlet. This depends heavily on the client installation and
  -          should not relied on except in tightly controlled environments.
  -        </p>
  -<p>
  -          See also http://marc.theaimsgroup.com/?l=fop-dev&amp;m=101065988325115&amp;w=2
  -        </p>
  -</div>
  -</div>
  -<a name="N104C9"></a><a name="part-N10422"></a>
  -<h4>7. More general questions regarding XSLT and XSLFO and basic XML</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N104CD"></a><a name="faq-N10427"></a>
  -<h5>7.1. (FO) How do I vertically center an image or a table (or
  -      whatever)?<span style="float: right"><a href="#faq-N10427-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Use display-align="center". FOP implements this for block containers
  -          and table cell. A small self-contained document centering an image on
  -          a page:
  -        </p>
  -<pre class="code">&lt;?xml version="1.0"?&gt;
  -&lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
  -  xmlns:svg="http://www.w3.org/2000/svg"&gt;
  -  &lt;fo:layout-master-set&gt;
  -    &lt;fo:simple-page-master master-name="content"
  -      page-width="210mm" page-height="297mm"&gt;
  -      &lt;fo:region-body/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -  &lt;/fo:layout-master-set&gt;
  -  &lt;fo:page-sequence master-reference="content"&gt;
  -    &lt;fo:flow flow-name="xsl-region-body"&gt;
  -      &lt;fo:table table-layout="fixed" width="100%"&gt;
  -        &lt;fo:table-column column-width="proportional-column-width(1)"/&gt;
  -        &lt;fo:table-body&gt;
  -          &lt;fo:table-row height="297mm"&gt;
  -            &lt;fo:table-cell display-align="center"&gt;
  -              &lt;fo:block text-align="center"&gt;
  -                &lt;fo:external-graphic src="fop.jpg"/&gt;
  -              &lt;/fo:block&gt;
  -            &lt;/fo:table-cell&gt;
  -          &lt;/fo:table-row&gt;
  -        &lt;/fo:table-body&gt;
  -      &lt;/fo:table&gt;
  -    &lt;/fo:flow&gt;
  -  &lt;/fo:page-sequence&gt;
  -&lt;/fo:root&gt;</pre>
  -</div>
  -<a name="N104D9"></a><a name="faq-N10437"></a>
  -<h5>7.2. (FO) How to get page numbers printed on the "outer side" of the
  -        page (for books, obviously)?<span style="float: right"><a href="#faq-N10437-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          That's about different static content on <a target="_top" href="#oddeven">odd/even pages</a>.
  -        </p>
  -</div>
  -<a name="N104E5"></a><a name="faq-N10447"></a>
  -<h5>7.3. (FO) How do I get a special header on the first page?<span style="float: right"><a href="#faq-N10447-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          You can insert it into the flow instead of the static content.
  -          Alternatively, use a page master referring to different page masters
  -          for the first page and the rest. It is quite similar to the odd/even
  -          page mechanism. A code sample:
  -        </p>
  -<pre class="code">&lt;?xml version="1.0"?&gt;
  -&lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"&gt;
  -  &lt;fo:layout-master-set&gt;
  -    &lt;fo:simple-page-master master-name="first"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body margin-bottom="20mm"/&gt;
  -      &lt;fo:region-after region-name="footer-first" extent="20mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:simple-page-master master-name="rest"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body margin-bottom="20mm"/&gt;
  -      &lt;fo:region-after region-name="footer-rest" extent="20mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:page-sequence-master master-name="document"&gt;
  -      &lt;fo:repeatable-page-master-alternatives&gt;
  -        &lt;fo:conditional-page-master-reference page-position="first"
  -          master-reference="first"/&gt;
  -        &lt;fo:conditional-page-master-reference page-position="rest"
  -          master-reference="rest"/&gt;
  -      &lt;/fo:repeatable-page-master-alternatives&gt;
  -    &lt;/fo:page-sequence-master&gt;
  -  &lt;/fo:layout-master-set&gt;
  -  &lt;fo:page-sequence master-reference="document"&gt;
  -    &lt;fo:static-content flow-name="footer-first"&gt;
  -      &lt;fo:block text-align="center"&gt;First page.&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:static-content flow-name="footer-rest"&gt;
  -      &lt;fo:block text-align-last="center"&gt;Other page.&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:flow flow-name="xsl-region-body"&gt;
  -      &lt;fo:block/&gt;
  -      &lt;fo:block break-before="page"/&gt;
  -      &lt;fo:block break-before="page"/&gt;
  -    &lt;/fo:flow&gt;
  -  &lt;/fo:page-sequence&gt;
  -&lt;/fo:root&gt;</pre>
  -</div>
  -<a name="N104F1"></a><a name="oddeven"></a>
  -<h5>7.4. (FO) Different static content for odd/even pages<span style="float: right"><a href="#oddeven-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          There are examples in the FO distribution and in the XSL FAQ FO
  -          section http://www.dpawson.co.uk/xsl/sect3/index.html
  -        </p>
  -<p>
  -          Define a page master with alternating pages masters for odd and even
  -          pages, specify appropriate regions in these page masters, and be sure
  -          to give them different names. You use these names to put different
  -          static content in these regions. A self contained document
  -          demonstrating this:
  -        </p>
  -<pre class="code">&lt;?xml version="1.0"?&gt;
  -&lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"&gt;
  -  &lt;fo:layout-master-set&gt;
  -    &lt;fo:simple-page-master master-name="even"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body margin-bottom="20mm"/&gt;
  -      &lt;fo:region-after region-name="footer-even" extent="20mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:simple-page-master master-name="odd"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body margin-bottom="20mm"/&gt;
  -      &lt;fo:region-after region-name="footer-odd" extent="20mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:page-sequence-master master-name="document"&gt;
  -      &lt;fo:repeatable-page-master-alternatives&gt;
  -        &lt;fo:conditional-page-master-reference odd-or-even="even"
  -          master-reference="even"/&gt;
  -        &lt;fo:conditional-page-master-reference odd-or-even="odd"
  -          master-reference="odd"/&gt;
  -      &lt;/fo:repeatable-page-master-alternatives&gt;
  -    &lt;/fo:page-sequence-master&gt;
  -  &lt;/fo:layout-master-set&gt;
  -  &lt;fo:page-sequence master-reference="document"&gt;
  -    &lt;fo:static-content flow-name="footer-even"&gt;
  -      &lt;fo:block text-align="start"&gt;&lt;fo:page-number/&gt;&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:static-content flow-name="footer-odd"&gt;
  -      &lt;fo:block text-align-last="end"&gt;&lt;fo:page-number/&gt;&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:flow flow-name="xsl-region-body"&gt;
  -      &lt;fo:block/&gt;
  -      &lt;fo:block break-before="page"/&gt;
  -    &lt;/fo:flow&gt;
  -  &lt;/fo:page-sequence&gt;
  -&lt;/fo:root&gt;</pre>
  -</div>
  -<a name="N10500"></a><a name="faq-N1046B"></a>
  -<h5>7.5. (FO) How do I omit my headers on a blank page? How do I write
  -      "This page is left blank" on an intentionally blank page?<span style="float: right"><a href="#faq-N1046B-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          A blank page can be forced by a <span class="codefrag">break-before="page-even"</span>
  -          or similar properties, or by a force-page-count="end-on-odd" on a page
  -          sequence, which ensures a new chapter or something starts on the
  -          preferred page.
  -        </p>
  -<p>
  -          You can define a conditional page master with a page master specific
  -          for blank pages. This allows you to specify static content for blank
  -          pages (by definition, a page is blank if no content from a flow is
  -          rendered on the page). You can omit your normal headers and footers,
  -          and use for example an extended header to print the "..left blank"
  -          statement.
  -        </p>
  -<pre class="code">&lt;?xml version="1.0"?&gt;
  -&lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"&gt;
  -  &lt;fo:layout-master-set&gt;
  -    &lt;fo:simple-page-master master-name="normal"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body margin-bottom="20mm"/&gt;
  -      &lt;fo:region-after region-name="footer-normal" extent="20mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:simple-page-master master-name="blank"
  -      page-height="297mm" page-width="210mm"
  -      margin-top="20mm" margin-bottom="20mm"
  -      margin-left="25mm" margin-right="25mm"&gt;
  -      &lt;fo:region-body/&gt;
  -      &lt;fo:region-before region-name="header-blank" extent="297mm"/&gt;
  -    &lt;/fo:simple-page-master&gt;
  -    &lt;fo:page-sequence-master master-name="document"&gt;
  -      &lt;fo:repeatable-page-master-alternatives&gt;
  -        &lt;fo:conditional-page-master-reference blank-or-not-blank="not-blank"
  -          master-reference="normal"/&gt;
  -        &lt;fo:conditional-page-master-reference blank-or-not-blank="blank"
  -          master-reference="blank"/&gt;
  -      &lt;/fo:repeatable-page-master-alternatives&gt;
  -    &lt;/fo:page-sequence-master&gt;
  -  &lt;/fo:layout-master-set&gt;
  -  &lt;fo:page-sequence master-reference="document" force-page-count="end-on-even"&gt;
  -    &lt;fo:static-content flow-name="footer-normal"&gt;
  -      &lt;fo:block text-align="center"&gt;Normal footer&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:static-content flow-name="header-blank"&gt;
  -      &lt;fo:block space-before="100mm" text-align-last="center"&gt;
  -        Intentionally left blank.&lt;/fo:block&gt;
  -    &lt;/fo:static-content&gt;
  -    &lt;fo:flow flow-name="xsl-region-body"&gt;
  -      &lt;fo:block/&gt;
  -    &lt;/fo:flow&gt;
  -  &lt;/fo:page-sequence&gt;
  -&lt;/fo:root&gt;</pre>
  -</div>
  -<a name="N10512"></a><a name="faq-N10481"></a>
  -<h5>7.6. (FO) How to get Euro sign/checkbox/some other stuff<span style="float: right"><a href="#faq-N10481-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Try to look it up in the Unicode reference at the <a href="http://www.unicode.org">Unicode Consortium</a>, in
  -            particular search the <a href="http://www.unicode.org/charts/charindex.html">reference by
  -            name</a>. Use <a href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-references">XML
  -            character references</a> to put the character into your source
  -          XML, XSLT or FO.
  -        </p>
  -<p>
  -          Watch out for font traps, see #, change font temporarily using
  -          fo:inline if necessary.
  -        </p>
  -<p>
  -          Alternative: Use an embedded graphic: GIF, PNG, SVG, whatever.
  -        </p>
  -</div>
  -<a name="N1052C"></a><a name="faq-N1049F"></a>
  -<h5>7.7. (FO) How do I keep linebreaks/hard spaces? How do I get
  -        preformatted text displayed as expected.<span style="float: right"><a href="#faq-N1049F-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          The specification provides some properties for this: <a href="http://www.w3.org/TR/xsl/slice7.html#white-space-collapse">white
  -          space collapsing</a> and <a href="http://www.w3.org/TR/xsl/slice7.html#linefeed-treatment">line
  -          feed treatment</a>. In FOP, use white-space-collapse="false" on an
  -          enclosing block. This will also preserve line breaks (which is
  -          actually a bug, expect this to be changed).
  -        </p>
  -</div>
  -<a name="N1053C"></a><a name="faq-N104B3"></a>
  -<h5>7.8. (FO) How do I print the total number of pages, like in "page 1
  -      of 12"<span style="float: right"><a href="#faq-N104B3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<a name="pagenum"></a>
  -<p>
  -          (XSL FAQ)
  -        </p>
  -<p>
  -          Put an empty block with an id at the end of the flow:
  -        </p>
  -<pre class="code">&lt;fo:flow ...&gt;
  -   ...
  -  &lt;fo:block id="last-page"/&gt;
  - &lt;/fo:flow&gt;</pre>
  -<p>
  -          Get the number of the last page as follows:
  -        </p>
  -<pre class="code"> &lt;fo:page-nuber-citation ref-id="last-page"/&gt;</pre>
  -<p>
  -          This does not work for all problems, for example if you have multiple
  -          page sequences, an initial page number different from 1, or if you
  -          force a certain page count, thereby producing blank pages at the end.
  -        </p>
  -<p>
  -          There is no reliable way to get the real total page count with FO
  -          mechanisms, you can only get <em>page numbers</em>.
  -        </p>
  -<p>
  -          The FOP library provides a method to get the total page count after a
  -          FO document has been rendered. You can implement your own wrapper to
  -          do a dummy rendering, inquire the total page count and the perform the
  -          real rendering, passing the total page count to the XSLT processor to
  -          splice it into the generated FO. A sample code:
  -        </p>
  -<pre class="code">import org.apache.fop.apps.*;
  -import org.xml.sax.*;
  -import java.io.*;
  -import javax.xml.transform.*;
  -import javax.xml.transform.sax.*;
  -import javax.xml.transform.stream.*;
  -
  -class rendtest {
  -
  -  public static void main(String args[]) {
  -    try {
  -      Driver driver=new Driver();
  -      driver.setOutputStream(new FileOutputStream(args[2]));
  -      driver.setRenderer(Driver.RENDER_PDF);
  -      Transformer transformer=TransformerFactory.newInstance()
  -        .newTransformer(new StreamSource(new File(args[1])));
  -      transformer.setParameter("page-count","#");
  -      transformer.transform(new StreamSource(new File(args[0])),
  -        new SAXResult(driver.getContentHandler()));
  -      String pageCount=Integer.toString(driver.getResults().getPageCount());
  -      driver=new Driver();
  -      driver.setOutputStream(new FileOutputStream(args[2]));
  -      driver.setRenderer(Driver.RENDER_PDF);
  -      transformer=TransformerFactory.newInstance()
  -        .newTransformer(new StreamSource(new File(args[1])));
  -      transformer.setParameter("page-count",pageCount);
  -      transformer.transform(new StreamSource(new File(args[0])),
  -        new SAXResult(driver.getContentHandler()));
  -    }
  -    catch( Exception e) {
  -      e.printStackTrace();
  -    }
  -  }
  -}</pre>
  -<p>
  -          Declare and use the parameter "page-count" in your XSLT. Be aware you
  -          may run into convergence problems: replacing the "#" placeholder from
  -          the first run by the actual page count may change it.
  -        </p>
  -</div>
  -<a name="N10568"></a><a name="faq-N104E3"></a>
  -<h5>7.9. (FO) The header overlaps body content. The body extends into
  -      footer.<span style="float: right"><a href="#faq-N104E3-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Contrary to popular opinion, the regions on a page may overlap.
  -          Defining a certain body region does not automatically constrain other
  -          regions, this has to be done explicitely.
  -        </p>
  -<p>
  -          If you have a header region with an extent of 20mm, you should define
  -          a margin for the body region of at least 20mm too, otherwise the
  -          header content may overwrite some stuff in the body region. This
  -          applies similarly to the extent of the after region and the bottom
  -          margin of the body region.
  -        </p>
  -<p>
  -          The overlap effect can be used creatively for some purposes.
  -        </p>
  -</div>
  -<a name="N10576"></a><a name="faq-N104F5"></a>
  -<h5>7.10. (FO) How do I get lines in the document, as separators, side
  -      bars or folding marks?<span style="float: right"><a href="#faq-N104F5-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Several possibilities:
  -        </p>
  -<ul>
  -          
  -<li>
  -            Use fo:leader (look up the details in the <a href="http://www.w3.org/TR/xsl/slice6.html#fo_leader">XSLFO
  -            specification</a>, or use a book). For horizontal lines only.
  -          </li>
  -          
  -<li>
  -            Use a solid border on a suitable fo:block. Horizontal and vertical
  -            lines only.
  -          </li>
  -          
  -<li>
  -            Insert a graphic. GIF, PNG SVG, whatever.
  -          </li>
  -        
  -</ul>
  -</div>
  -<a name="N1058E"></a><a name="faq-N10511"></a>
  -<h5>7.11. (XML) Complaints about &amp;nbsp;. How do I get a non-breaking
  -      space in FO?<span style="float: right"><a href="#faq-N10511-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Use &amp;#160; everywhere. In your own XML, you could also use a DTD
  -          which declares the entity.
  -        </p>
  -</div>
  -<a name="N10596"></a><a name="faq-N1051D"></a>
  -<h5>7.12. (XML) There are complaints about undefined entities, for example
  -      complaints about &amp;uuml; which used to work in HTML. How do I enter
  -      special characters like in HTML?<span style="float: right"><a href="#faq-N1051D-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Don't use names as in HTML, use numbers (unless you have a DTD which
  -          declares the entities). For predefined HTML entities and their Unicode
  -          codepoints see <a href="http://www.w3.org/TR/html4/sgml/entities.html">Character entity
  -          references in HTML 4</a>
  -        
  -</p>
  -</div>
  -<a name="N105A2"></a><a name="faq-N1052D"></a>
  -<h5>7.13. (XML) There are complaints about illegal characters and entities
  -      in the input.<span style="float: right"><a href="#faq-N1052D-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Make sure ampersands in text and attributes are written as &amp;amp;,
  -          "&lt;" is written as &amp;lt; and "&gt;" as &amp;gt;. It's not necessary
  -          everywhere but do it just to be sure.
  -        </p>
  -<p>
  -          The XML parser should give the proper line and possibly column for
  -          offending characters.
  -        </p>
  -<p>
  -          Refer to the <a href="../resources.html">XML specification</a> or to a good tutorial for
  -          details of the XML file format.
  -        </p>
  -</div>
  -<a name="N105B4"></a><a name="faq-N10543"></a>
  -<h5>7.14. (XML) There are complaints about illegal bytes or characters in
  -      the input. There are odd characters in the result.<span style="float: right"><a href="#faq-N10543-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Usually, this is a character encoding problem. See <a href="http://www.dpawson.co.uk/xsl">XSL FAQ</a>. Many software
  -          packages producing XML, in particular most XSLT processors, produce by
  -          default UTF-8 encoded files. If you view them with something not aware
  -          of the encoding, like Notepad for Win95/98/ME/NT, funny characters are
  -          displayed. A &Aring; is a giveaway.
  -        </p>
  -</div>
  -</div>
  -<a name="N105C0"></a><a name="part-N10554"></a>
  -<h4>8. General suggestions. How to solve problems</h4>
  -<div style="margin-left: 0 ; border: 2px">
  -<a name="N105C4"></a><a name="faq-N10559"></a>
  -<h5>8.1. Where to post bugs<span style="float: right"><a href="#faq-N10559-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          See docs. See also <a target="_top" href="#postquestions">"where to post
  -          questions"</a>.
  -        </p>
  -</div>
  -<a name="N105D0"></a><a name="postquestions"></a>
  -<h5>8.2. Where to post questions.<span style="float: right"><a href="#postquestions-menu">^</a></span>
  -</h5>
  -<div style="margin-left: 15 ; border: 2px">
  -<p>
  -          Decide where to post:
  -        </p>
  -<ul>
  -          
  -<li>
  -            You get exceptions. First, check the FAQ whether the exception is
  -            mentioned. ClassNotFoundException, NoSuchMethodException and
  -            NoSuchFieldException problems are almost always a problem with the
  -            local environment. Check <a href="http://nagoya.apache.org">bugzilla</a>. If still not found,
  -            post to fop-dev.
  -          </li>
  -          
  -<li>
  -            Something doesn't work with FOP but works with another formatter
  -            (AntennaHouse, PassiveTex). Check whether this is already mentioned
  -            in the release notes, the FOP limitations document or the FAQ. Post
  -            to fop-dev or open a bug on <a href="http://nagoya.apache.org">bugzilla</a>.
  -          </li>
  -          
  -<li>
  -            Question about how to use FOP, how to perform certain tasks with FOP
  -            or how to integrate FOP into another application should be posted to
  -            fop-user.
  -          </li>
  -          
  -<li>
  -            XSLT specific stuff sould go to the <a href="http://www.mulberrytech.com/xsl/xsl-list/">XSL
  -            list</a>. This includes problems with the language and XSLT
  -            How-Tos.
  -          </li>
  -          
  -<li>
  -            Problems specific to a certain XSLT processor, like Xalan, Saxon or
  -            MSXML, should be handled by processor specific lists. This includes
  -            problems with deployment, processor specific extensions, suspected
  -            bugs and processor specific APIs.
  -          </li>
  -          
  -<li>
  -            Problems with servlet containers should be asked on the vendor
  -            specific lists for these software packets.
  -          </li>
  -          
  -<li>
  -            More general questions regarding Java, including deployment, Java
  -            APIs, classpath issues and property definitions should be redirected
  -            to some Java specific list.
  -          </li>
  -        
  -</ul>
  +<p>Yes. See also the <a href="../faq.html">FOP General FAQs</a>.</p>
   </div>
   </div>
   </div>
  
  
  
  1.6       +395 -13348xml-site/targets/fop/dev/faq.pdf
  
  	<<Binary file>>
  
  
  1.6       +4 -0      xml-site/targets/fop/dev/fonts.html
  
  Index: fonts.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/fonts.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- fonts.html	11 Mar 2003 15:34:48 -0000	1.5
  +++ fonts.html	25 Mar 2003 02:34:13 -0000	1.6
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.8       +4 -0      xml-site/targets/fop/dev/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/index.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- index.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ index.html	25 Mar 2003 02:34:13 -0000	1.8
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.8       +4 -0      xml-site/targets/fop/dev/svg.html
  
  Index: svg.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/fop/dev/svg.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- svg.html	11 Mar 2003 15:34:48 -0000	1.7
  +++ svg.html	25 Mar 2003 02:34:13 -0000	1.8
  @@ -180,6 +180,10 @@
   <li>
   <a href="../design/index.html">Design</a>
   </li>
  +      
  +<li>
  +<a href="tools.html">Tools</a>
  +</li>
       
   </ul>
   </li>
  
  
  
  1.1                  xml-site/targets/fop/dev/compiling.html
  
  Index: compiling.html
  ===================================================================
  <html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>dev/compiling.html</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/dev/compiling.html</pre></p><hr size="1" noshade="true"/></body></html>
  
  
  1.1                  xml-site/targets/fop/dev/download.html
  
  Index: download.html
  ===================================================================
  <html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>dev/download.html</pre></p><p><b>missing-file</b><pre>/usr/serverlocal/forrestbot/scripts/work/build/bot/xml-fop/site/dev/download.html</pre></p><hr size="1" noshade="true"/></body></html>
  
  
  1.1                  xml-site/targets/fop/dev/tools.html
  
  Index: tools.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  <html>
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <title>Developer Tools</title>
  <link type="text/css" href="../skin/page.css" rel="stylesheet">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
  <!--================= start Navigation Path ==================-->
  <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" border="0" src="../skin/images/spacer.gif"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td>
  </tr>
  <tr>
  <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0" src="../skin/images/spacer.gif"></td>
  </tr>
  </table>
  <!--================= end Navigation Path ==================-->
  <!--================= start Banner ==================-->
  <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <!--================= start Group Logo ==================-->
  <td bgcolor="#294563"><a href="http://xml.apache.org/"><img border="0" class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a></td>
  <!--================= end Group Logo ==================-->
  <!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/fop/"><img border="0" class="logoImage" alt="FOP" src="../images/logo.jpg"></a></td>
  <!--================= end Project Logo ==================-->
  <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563">
  <form target="_blank" action="http://www.google.com/search" method="get">
  <table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F">
  <tr>
  <td colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="xml.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
  <br>
  <font face="Arial, Helvetica, Sans-serif" size="2" color="white">
                        the Apache XML site
                        
                        
                      </font></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td><img alt="" border="0" height="10" width="9" src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10" width="9" src="../skin/images/search-right.gif"></td>
  </tr>
  </table>
  </form>
  </td>
  <!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td valign="bottom" bgcolor="#294563" colspan="2">
  <!--================= start Tabs ==================-->
  <div class="tab">
  <table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td width="8"><img alt="" height="8" width="8" src="../skin/images/spacer.gif"></td><td valign="bottom">
  <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a href="../index.html"><font face="Arial, Helvetica, Sans-serif">Home</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
  </tr>
  </table>
  </td><td width="8"><img alt="" height="8" width="8" src="../skin/images/spacer.gif"></td><td valign="bottom">
  <table summary="selected tab" style="height: 1.7em" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a href="index.html"><font color="#000000">Development</font></a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../skin/images/tabSel-right.gif"></td>
  </tr>
  </table>
  </td><td width="8"><img alt="" height="8" width="8" src="../skin/images/spacer.gif"></td><td valign="bottom">
  <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a href="../design/index.html"><font face="Arial, Helvetica, Sans-serif">Redesign</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
  </tr>
  </table>
  </td><td width="8"><img alt="" height="8" width="8" src="../skin/images/spacer.gif"></td><td valign="bottom">
  <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a href="../design/alt.design/index.html"><font face="Arial, Helvetica, Sans-serif">alt design</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../skin/images/tab-right.gif"></td>
  </tr>
  </table>
  </td>
  </tr>
  </table>
  </div>
  <!--================= end Tabs ==================-->
  </td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  </table>
  <!--================= end Banner ==================-->
  <!--================= start Menu, NavBar, Content ==================-->
  <table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td valign="top">
  <table summary="menu" border="0" cellspacing="0" cellpadding="0">
  <tr>
  <!--================= start left top NavBar ==================-->
  <td rowspan="3" valign="top">
  <table summary="blue line" border="0" cellpadding="0" cellspacing="0">
  <tr>
  <td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif">&nbsp;</font></td>
  </tr>
  <tr>
  <td bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  </table>
  </td>
  <!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
  <!--================= start Menu items ==================-->
  <div class="menu">
  <ul>
  <li>
  <font color="#CFDCED">Index</font>
  <ul>
        
  <li>
  <a href="../index.html">FOP Index</a>
  </li>
      
  </ul>
  </li>
  <li>
  <font color="#CFDCED">About</font>
  <ul>
        
  <li>
  <a href="index.html">Index</a>
  </li>
        
  <li>
  <a href="faq.html">FAQs</a>
  </li>
        
  <li>
  <a href="examples.html">Examples</a>
  </li>
      
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Using</font>
  <ul>
        
  <li>
  <a href="extensions.html">Extensions</a>
  </li>
        
  <li>
  <a href="configuration.html">Configuration</a>
  </li>
      
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Extras</font>
  <ul>
        
  <li>
  <a href="svg.html">SVG</a>
  </li>
        
  <li>
  <a href="fonts.html">Fonts</a>
  </li>
      
  </ul>
  </li>
  <li>
  <font color="#CFDCED">Developers</font>
  <ul>
        
  <li>
  <a target="_blank" href="http://nagoya.apache.org/wiki/apachewiki.cgi?FOPProjectPages">FOP Wiki</a>
  </li>
        
  <li>
  <a href="../design/index.html">Design</a>
  </li>
        
  <li>
  <span class="sel"><font color="#ffcc00">Tools</font></span>
  </li>
      
  </ul>
  </li>
  </ul>
  </div>
  <!--================= end Menu items ==================-->
  </td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/spacer.gif"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="../skin/images/menu-right.gif"></td>
  </tr>
  <tr>
  <td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  </table>
  </td><td valign="top" width="100%">
  <table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
  <!--================= start middle NavBar ==================-->
  <tr>
  <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
                  &nbsp;
                  
                  </font><img width="10" height="8" alt="" src="../skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">
                  &nbsp;
                  
                  </font><img width="10" height="8" alt="" src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <tr>
  <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <!--================= end middle NavBar ==================-->
  <!--================= start Content==================-->
  <tr>
  <td align="left" width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td><td align="left" width="100%">
  <div class="content">
  <table class="title" summary="">
  <tr>
  <td valign="middle">
  <h1>Developer Tools</h1>
  </td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="tools.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
            PDF</a></td>
  </tr>
  </table>
  <ul class="minitoc">
  <li>
  <a href="#cvs">Concurrent Versions System (CVS)</a>
  <ul class="minitoc">
  <li>
  <a href="#cvs_general">General</a>
  </li>
  <li>
  <a href="#wincvs_download">Step-by-step instructions for downloading FOP using WinCVS</a>
  </li>
  <li>
  <a href="#cvs_patch">Creating Patches</a>
  </li>
  </ul>
  </li>
  <li>
  <a href="#ide">Integrated Development Environments (IDEs)</a>
  </li>
  </ul>
      
  <p>This page documents items that may be helpful to other developers, especially to those who are new to FOP. Exhaustive treatment of these topics is better suited to other fora, but the information presented here is intended to deal with FOP-specific issues related to these tools, especially "gotchas", and to help developers get jump-started.</p>
      
  <a name="N101C1"></a><a name="cvs"></a>
  <h3>Concurrent Versions System (CVS)</h3>
  <div style="margin-left: 0 ; border: 2px">
  <a name="N101C7"></a><a name="cvs_general"></a>
  <h4>General</h4>
  <div style="margin-left: 0 ; border: 2px">
  <p>Visit <a href="http://xml.apache.org/cvs.html">Apache XML CVS Repositories</a> for useful information.</p>
  <p>You will need a CVS client to be able to gain access to the FOP repository. For general CVS information, visit <a href="http://www.cvshome.org">CVS Home</a>. Nice GUI clients for Windows, Mac, and X(??) can be found at <a href="http://www.wincvs.org">WinCVS</a>.</p>
  <p>Regardless of what platform you develop on, please be sure to submit patches that use Unix line endings. If you are using WinCVS, check code out this way by going to the Admin / Preferences menu item, clicking on the "Globals" tab, then select the "Checkout text files with the Unix LF (0xa)" option. You will also need to use an editor that supports opening and saving files using Unix line endings.</p>
  </div>
  <a name="N101E3"></a><a name="wincvs_download"></a>
  <h4>Step-by-step instructions for downloading FOP using WinCVS</h4>
  <div style="margin-left: 0 ; border: 2px">
  <ul>
            
  <li>Select "Create / Checkout Module" menu item.</li>
            
  <li>&ldquo;Checkout Settings&rdquo; Tab:
              <ul>
                
  <li>&ldquo;Enter the module name and path on the server:&rdquo;<br>
                  
  <span class="codefrag">xml-fop</span>
                
  </li>
                
  <li>&ldquo;Local folder to checkout to:&rdquo;<br>Enter your local directory</li>
              
  </ul>
            
  </li>
            
  <li>&ldquo;Checkout Options&rdquo; Tab:
            <ul>
                
  <li>If you are checking out the trunk, unset all options.</li>
                
  <li>If you are checking out the maintenance branch (currently distributed code), check &ldquo;By revision/tag/branch:&rdquo; and enter <span class="codefrag">fop-0_20_2-maintain</span>.</li>
              
  </ul>
            
  </li>
            
  <li>&ldquo;General&rdquo; Tab:
            <ul>
                
  <li>&ldquo;Enter the CVSROOT:&rdquo;<br>
                  
  <span class="codefrag">:pserver:anoncvs@cvs.apache.org:/home/cvspublic</span>
                
  </li>
                
  <li>&ldquo;Authentication:&rdquo;<br>
                  
  <span class="codefrag">&ldquo;passwd&rdquo; file on the cvs server</span>
                
  </li>
              
  </ul>
            
  </li>
            
  <li>&ldquo;Globals&rdquo; Tab:
            <ul>
                
  <li>check &ldquo;Checkout text files with the Unix LF (Oxa)&rdquo;</li>
              
  </ul>
            
  </li>
            
  <li>Click "OK" and the download should begin.</li>
          
  </ul>
  </div>
  <a name="N10234"></a><a name="cvs_patch"></a>
  <h4>Creating Patches</h4>
  <div style="margin-left: 0 ; border: 2px">
  <ul>
            
  <li>
              
  <span class="codefrag">cd</span> to a directory that contains all of the changes that you wish to include in the patch. To comprehend the entire distribution, <span class="codefrag">cd</span> to the directory above the "xml-fop" directory that was created when you checked out the code.</li>
            
  <li>Run: <span class="codefrag">cvs -q diff -wu &lt;list of items to diff&gt;</span>
              
  <br>The &lt;list of items to diff&gt; is a space-separated list of files and directories relative to the current directory that you wish to include in the diff. For example, to include the entire distribution, assuming that you are in the directory, above xml-fop, simply enter "xml-fop". This will recursively go through the directories beneath xml-fop to diff each file.</li>
            
  <li>If you are running WinCVS, select "Admin/Command Line" for a console in which to key the above command.</li>
            
  <li>On a Linux/Unix machine, you will want to redirect the output from the above command into a file. If you are using GNU WinCVS, you can cut the output from the console window and paste it into a file. The "-w" ignores whitespace differences. The "-u" puts the diff in "universal" format. You may wish to use the "-N" option as well, which is supposed to treat new files as if there were an old 0 byte file -- in other words, it is supposed to include the new file in the patch. However, it only operates on files that have been "add"ed to the CVS repository, which cannot be done without commit access.</li>
          
  </ul>
  </div>
  </div>
      
  <a name="N10256"></a><a name="ide"></a>
  <h3>Integrated Development Environments (IDEs)</h3>
  <div style="margin-left: 0 ; border: 2px">
  <p>An IDE is not required, but will generally be found to be helpful, especially for serious debugging and refactoring.</p>
  <p>Borland's JBuilder 7/8 does not support Ant builds unless you have the Enterprise Edition (which is quite expensive). This causes problems with any code that is generated by the Ant build. First, you must run the Ant build before you can use the IDE. Second, when you are editing in the IDE, you must be editing the generated files, which means that you must make any changes to the source files in another editor. This is less serious for development on the trunk, but in the maintenance branch, all source files were "generated".</p>
  <p>Sun ONE Studio Four does support Ant, but seems to use a built-in version, and as of this writing chokes on the FOP build file, saying that it is not valid. There is awkward because there is no official DTD for Ant, and it may be merely an Ant version issue.</p>
  </div>
    
  </div>
  </td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
  </tr>
  <!--================= end Content==================-->
  </table>
  </td>
  </tr>
  </table>
  <!--================= end Menu, NavBar, Content ==================-->
  <!--================= start Footer ==================-->
  <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0">
  <tr>
  <td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../skin/images/spacer.gif"><a href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a href="../skin/images/chapter.gif"></a><a href="../skin/images/chapter_open.gif"></a><a href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
  </tr>
  <tr>
  <td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
            1999-2003&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
                document.write(" - "+"Last Published: " + document.lastModified);
              //  --></script></font></td>
  </tr>
  <tr>
  <td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
  </tr>
  </table>
  <!--================= end Footer ==================-->
  </body>
  </html>
  
  
  
  1.1                  xml-site/targets/fop/dev/tools.pdf
  
  	<<Binary file>>
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message