You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlgraphics.apache.org by vh...@apache.org on 2007/08/23 21:00:51 UTC

svn commit: r569118 [48/49] - in /xmlgraphics/site/deploy/fop: ./ 0.93/ 0.94/ 0.94/images/ dev/ dev/design/ skin/ trunk/

Added: xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml (added)
+++ xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,223 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+--><!-- $Id$ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document>
+  <header>
+    <title>PDF encryption.</title>
+    <version>$Revision: 569104 $</version>
+    <authors>
+      <person name="J.Pietschmann" email="pietsch@apache.org"/>
+      <person name="Jeremias Märki" email="jeremias@apache.org"/>
+    </authors>
+  </header>
+  <body>
+    <section>
+      <title>Overview</title>
+      <p>
+        FOP supports encryption of PDF output, thanks to Patrick
+        C. Lankswert. This feature is commonly used to prevent
+        unauthorized viewing, printing, editing, copying text from the
+        document and doing annotations. It is also possible to ask the
+        user for a password in order to view the contents. Note that
+        there already exist third party applications which can decrypt
+        an encrypted PDF without effort and allow the aforementioned
+        operations, therefore the degree of protection is limited.
+      </p>
+      <p>
+        For further information about features and restrictions regarding PDF
+        encryption, look at the documentation coming with Adobe Acrobat or the
+        technical documentation on the Adobe web site.
+      </p>
+    </section>
+    <section>
+      <title>Usage (command line)</title>
+      <p>
+        Encryption is enabled by supplying any of the encryption related
+        options.
+      </p>
+      <p>
+        An owner password is set with the <code>-o</code> option. This
+        password is actually used as encryption key. Many tools for
+        PDF processing ask for this password to disregard any
+        restriction imposed on the PDF document.
+      </p>
+      <p>
+        If no owner password has been supplied but FOP was asked to apply some
+        restrictions, a random password is used. In this case it is obviously
+        impossiible to disregard restrictions in PDF processing tools.
+      </p>
+      <p>
+        A user password, supplied with the <code>-u</code> option, will
+        cause the PDF display software to ask the reader for this password in
+        order to view the contents of the document. If no user password was
+        supplied, viewing the content is not restricted.
+      </p>
+      <p>
+        Further restrictions can be imposed by using the <code>-noprint</code>,
+        <code>-nocopy</code>, <code>-noedit</code> and
+        <code>-noannotations</code> options, which disable printing, copying
+        text, editing in Adobe Acrobat and making annotations, respectively.
+      </p>
+    </section>
+    <section>
+      <title>Usage (embedded)</title>
+      <p>
+        When FOP is embedded in another Java application you need to set an 
+        options map on the renderer. These are the supported options:
+      </p>
+      <table>
+        <tr>
+          <th colspan="1" rowspan="1">Option</th>
+          <th colspan="1" rowspan="1">Description</th>
+          <th colspan="1" rowspan="1">Values</th>
+          <th colspan="1" rowspan="1">Default</th>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">ownerPassword</td>
+          <td colspan="1" rowspan="1">The owner password</td>
+          <td colspan="1" rowspan="1">String</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">userPassword</td>
+          <td colspan="1" rowspan="1">The user password</td>
+          <td colspan="1" rowspan="1">String</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">allowPrint</td>
+          <td colspan="1" rowspan="1">Allows/disallows printing of the PDF</td>
+          <td colspan="1" rowspan="1">"TRUE" or "FALSE"</td>
+          <td colspan="1" rowspan="1">"TRUE"</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">allowCopyContent</td>
+          <td colspan="1" rowspan="1">Allows/disallows copy/paste of content</td>
+          <td colspan="1" rowspan="1">"TRUE" or "FALSE"</td>
+          <td colspan="1" rowspan="1">"TRUE"</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">allowEditContent</td>
+          <td colspan="1" rowspan="1">Allows/disallows editing of content</td>
+          <td colspan="1" rowspan="1">"TRUE" or "FALSE"</td>
+          <td colspan="1" rowspan="1">"TRUE"</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">allowEditAnnotations</td>
+          <td colspan="1" rowspan="1">Allows/disallows editing of annotations</td>
+          <td colspan="1" rowspan="1">"TRUE" or "FALSE"</td>
+          <td colspan="1" rowspan="1">"TRUE"</td>
+        </tr>
+      </table>
+      <note>
+        Encryption is enabled as soon as one of these options is set.
+      </note>
+      <p>
+        An example to enable PDF encryption in Java code:
+      </p>
+      <source xml:space="preserve"><![CDATA[
+import org.apache.fop.pdf.PDFEncryptionParams;
+
+[..]
+
+FOUserAgent userAgent = fopFactory.newFOUserAgent();
+useragent.getRendererOptions().put("encryption-params", new PDFEncryptionParams(
+    null, "password", false, false, true, true));
+Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
+[..]]]></source>
+      <p>
+        The parameters for the constructor of PDFEncryptionParams are:
+      </p>
+      <ol>
+        <li>userPassword: String, may be null</li>
+        <li>ownerPassword: String, may be null</li>
+        <li>allowPrint: true if printing is allowed</li>
+        <li>allowCopyContent: true if copying content is allowed</li>
+        <li>allowEditContent: true if editing content is allowed</li>
+        <li>allowEditAnnotations: true if editing annotations is allowed</li>
+      </ol>
+      <p>
+        Alternatively, you can set each value separately in the Map provided by 
+        FOUserAgent.getRendererOptions() by using the following keys:
+      </p>
+      <ol>
+        <li>user-password: String</li>
+        <li>owner-password: String</li>
+        <li>noprint: Boolean or "true"/"false"</li>
+        <li>nocopy: Boolean or "true"/"false"</li>
+        <li>noedit: Boolean or "true"/"false"</li>
+        <li>noannotations: Boolean or "true"/"false"</li>
+      </ol>
+    </section>
+    <section>
+      <title>Environment</title>
+      <p>
+        In order to use PDF encryption, FOP has to be compiled with
+        cryptography support. Currently, only <link href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html">JCE</link>
+        is supported. JCE is part of JDK 1.4. For earlier JDKs, it can
+        be installed separately. The build process automatically
+        detects JCE presence and installs PDF encryption support if
+        possible, otherwise a stub is compiled in.
+      </p>
+      <p>
+        Cryptography support must also be present at run time. In particular, a
+        provider for the RC4 cipher is needed. Unfortunately, the sample JCE
+        provider in Sun's JDK 1.4 does <strong>not</strong> provide RC4. If you
+        get a message saying
+      </p>
+      <source xml:space="preserve"><![CDATA["Cannot find any provider supporting RC4"]]></source>
+      <p>
+        then you don't have the needed infrastructure.
+      </p>
+      <p>
+        There are several commercial and a few Open Source packages which
+        provide RC4. A pure Java implementation is produced by <link href="http://www.bouncycastle.org/">The Legion of the Bouncy
+        Castle</link>. <link href="http://www.mozilla.org/projects/security/pki/jss/">Mozilla
+        JSS</link> is an interface to a native implementation.
+      </p>
+    </section>
+    <section id="install_crypto">
+      <title>Installing a crypto provider</title>
+      <p>
+        The pure Java implementation from <link href="http://www.bouncycastle.org/">Bouncy Castle</link> is easy to
+        install.
+      </p>
+      <ol>
+        <li>
+          Download the binary distribution for your JDK version. If you have JDK
+          1.3 or earlier you must also download a JCE from the same page.
+        </li>
+        <li>
+          Unpack the distribution. Add the jar file to your classpath. A
+          convenient way to use the jar on Linux is to simply drop it into the
+          FOP lib directory, it will be automatically picked up by
+          <code>fop.sh</code>.  If you have JDK 1.3 or earlier don't forget to
+          install the JCE as well.
+        </li>
+        <li>
+          Open the <code>java.security</code> file and add<br/>
+          <code>security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider</code>,<br/>
+          preferably at the end of the block defining the other crypto
+          providers. For JDK 1.4 this is detailed on <link href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html#InstallProvider">Sun's web site</link>.
+        </li>
+      </ol>
+      <p>
+        If you have any experience with Mozilla JSS or any other
+        cryptography provider, please post it to the fop-user list.
+      </p>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/site/deploy/fop/trunk/pdfencryption.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: xmlgraphics/site/deploy/fop/trunk/pdfx.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/pdfx.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/pdfx.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/pdfx.html Thu Aug 23 12:00:37 2007
@@ -58,10 +58,10 @@
 <a class="base-not-selected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.20.5/index.html">Version 0.20.5</a>
+<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../trunk/index.html">FOP Trunk</a>
@@ -178,10 +178,20 @@
     |start content
     +-->
 <div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="pdfx.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
+        XML</a>
+</div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="pdfx.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
 </div>
+<div class="trail">
+<text>Font size:</text> 
+	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
+	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
 <h1>PDF/X (ISO 15930)</h1>
 <div id="minitoc-area">
 <ul class="minitoc">
@@ -220,9 +230,9 @@
         PDF/X is a standard which faciliates prepress digital data exchange using PDF.
         Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X
         profiles. PDF/X-3:2003 is documented in 
-        <a href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=39940&ICS1=37&ICS2=100&ICS3=99">ISO 15930-6:2003(E)</a>. 
+        <a class="external" href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=39940&ICS1=37&ICS2=100&ICS3=99">ISO 15930-6:2003(E)</a>. 
         More info on PDF/X can be found on the  
-        <a href="http://www.pdfx.info/">PDF/X info site</a>.
+        <a class="external" href="http://www.pdfx.info/">PDF/X info site</a>.
       </p>
 </div>
     

Modified: xmlgraphics/site/deploy/fop/trunk/pdfx.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/pdfx.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/pdfx.pdf (original)
+++ xmlgraphics/site/deploy/fop/trunk/pdfx.pdf Thu Aug 23 12:00:37 2007
@@ -287,8 +287,8 @@
 42 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
 43 0 obj
@@ -301,22 +301,22 @@
 44 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
 45 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F9
-/BaseFont /Courier
+/Name /F2
+/BaseFont /Helvetica-Oblique
 /Encoding /WinAnsiEncoding >>
 endobj
 46 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F2
-/BaseFont /Helvetica-Oblique
+/Name /F9
+/BaseFont /Courier
 /Encoding /WinAnsiEncoding >>
 endobj
 47 0 obj
@@ -340,7 +340,7 @@
 endobj
 3 0 obj
 << 
-/Font << /F3 42 0 R /F5 43 0 R /F1 44 0 R /F9 45 0 R /F2 46 0 R /F7 47 0 R >> 
+/Font << /F1 42 0 R /F5 43 0 R /F3 44 0 R /F2 45 0 R /F9 46 0 R /F7 47 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -429,10 +429,10 @@
 0000009390 00000 n 
 0000009583 00000 n 
 0000009823 00000 n 
-0000009936 00000 n 
-0000010046 00000 n 
+0000009931 00000 n 
+0000010041 00000 n 
 0000010154 00000 n 
-0000010260 00000 n 
+0000010270 00000 n 
 0000010376 00000 n 
 trailer
 <<

Added: xmlgraphics/site/deploy/fop/trunk/pdfx.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/pdfx.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/pdfx.xml (added)
+++ xmlgraphics/site/deploy/fop/trunk/pdfx.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  Copyright 2006 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+--><!-- $Id$ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document>
+  <header>
+    <title>PDF/X (ISO 15930)</title>
+    <version>$Revision$</version>
+    <authors>
+      <person name="Jeremias Märki" email="jeremias@apache.org"/>
+    </authors>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <warning>
+        Support for PDF/X is available beginning with version 0.93. This feature is new and
+        may not be 100% complete, yet. Feedback is welcome.
+      </warning>
+      <p>
+        PDF/X is a standard which faciliates prepress digital data exchange using PDF.
+        Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X
+        profiles. PDF/X-3:2003 is documented in 
+        <link href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=39940&amp;ICS1=37&amp;ICS2=100&amp;ICS3=99">ISO 15930-6:2003(E)</link>. 
+        More info on PDF/X can be found on the  
+        <link href="http://www.pdfx.info/">PDF/X info site</link>.
+      </p>
+    </section>
+    <section id="status">
+      <title>Implementation Status</title>
+      <p>
+        <strong>PDF/X-3:2003</strong> is implemented to the degree that FOP supports 
+        the creation of the elements described in ISO 15930-6. 
+      </p>
+      <p>
+        An important restriction of the current implementation is that all normal 
+        RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color
+        space (XSL-FO and SVG both use sRGB as their default color space).
+        There's no conversion to a CMYK color space. Although sRGB is a
+        calibrated color space, its color space has a different size than a CMYK
+        color space which makes the conversion a lossy conversion and can lead to
+        unwanted results. Although the use of the calibrated sRGB has been promoted
+        for years, print shops usually prefer to convert an sRGB PDF to CMYK prior
+        to production. Until there's full CMYK support in FOP you will have to
+        work closely with your print service provider to make sure you get the 
+        intended result.
+      </p>
+      <p>
+        Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function).
+        Note that there are bugs in Adobe Acrobat which cause false alarms if both
+        PDF/A-1b and PDF/X-3:2003 are activated at the same time.
+      </p>
+    </section>
+    <section id="command-line">
+      <title>Usage (command line)</title>
+      <p>
+        To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" 
+        as a parameter. If there is a violation of one of the validation rules for 
+        PDF/X, an error message is presented and the processing stops.
+      </p>
+    </section>
+    <section id="embedded">
+      <title>Usage (embedded)</title>
+      <p>
+        When FOP is embedded in another Java application you can set a special option
+        on the renderer options in the user agent to activate the PDF/A-1b profile.
+        Here's an example:
+      </p>
+      <source xml:space="preserve"><![CDATA[
+FOUserAgent userAgent = fopFactory.newFOUserAgent();
+userAgent.getRendererOptions().put("pdf-x-mode", "PDF/X-3:2003");
+Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
+[..]]]></source>
+      <p>
+        If one of the validation rules of PDF/X is violated, an PDFConformanceException
+        (descendant of RuntimeException) is thrown.
+      </p>
+    </section>
+    <section id="rules">
+      <title>PDF/X in Action</title>
+      <p>
+        There are a number of things that must be looked after if you activate a PDF/X
+        profile. If you receive a PDFConformanceException, have a look at the following
+        list (not necessarily comprehensive):
+      </p>
+      <ul>
+        <li>
+          Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica)
+          you need to obtain a license for them and embed them like any other font.
+        </li>
+        <li>
+          Don't use PDF encryption. PDF/X doesn't allow it.
+        </li>
+        <li>
+          Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing
+          color spaces and FOP currently only properly supports the sRGB color space. However,
+          you will need to specify an 
+          <link href="configuration.html#pdf-renderer">output device profile</link>
+          (usually a CMYK profile) in the configuration. sRGB won't work here since it's a 
+          display device profile, not an output device profile.
+        </li>
+        <li>
+          Don't use non-RGB colors in SVG images. Same issue as with CMYK images.
+        </li>
+        <li>
+          Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF
+          is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003.
+        </li>
+        <li>
+          PDF is forced to version 1.4 if PDF/X-3:2003 is activated.
+        </li>
+      </ul>
+    </section>
+    <section id="profile-compatibility">
+      <title>PDF profile compatibility</title>
+      <p>
+        The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be 
+        activated at the same time.
+      </p>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: xmlgraphics/site/deploy/fop/trunk/pdfx.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/site/deploy/fop/trunk/pdfx.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: xmlgraphics/site/deploy/fop/trunk/running.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/running.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/running.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/running.html Thu Aug 23 12:00:37 2007
@@ -58,10 +58,10 @@
 <a class="base-not-selected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.20.5/index.html">Version 0.20.5</a>
+<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../trunk/index.html">FOP Trunk</a>
@@ -178,10 +178,20 @@
     |start content
     +-->
 <div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="running.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
+        XML</a>
+</div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="running.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
 </div>
+<div class="trail">
+<text>Font size:</text> 
+	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
+	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
 <h1>Running Apache FOP</h1>
 <div id="minitoc-area">
 <ul class="minitoc">
@@ -243,24 +253,24 @@
           <ul>
             
 <li>
-              A JAXP-compatible XML Parser (FOP comes with <a target="_blank" class="fork" href="http://xerces.apache.org">Apache Xerces-J</a>).
+              A JAXP-compatible XML Parser (FOP comes with <a class="external" href="http://xerces.apache.org">Apache Xerces-J</a>).
             </li>
             
 <li>
-              A JAXP-compatible XSLT Processor (FOP comes with <a target="_blank" class="fork" href="http://xalan.apache.org">Apache Xalan-J</a>).
+              A JAXP-compatible XSLT Processor (FOP comes with <a class="external" href="http://xalan.apache.org">Apache Xalan-J</a>).
             </li>
             
 <li>
 <a target="_blank" class="fork" href="http://xmlgraphics.apache.org/batik/">Apache Batik</a>, an SVG library.</li>
             
 <li>
-<a target="_blank" class="fork" href="http://jakarta.apache.org/commons/logging/">Apache Jakarta Commons Logging</a>, a logger abstraction kit.</li>
+<a class="external" href="http://jakarta.apache.org/commons/logging/">Apache Jakarta Commons Logging</a>, a logger abstraction kit.</li>
             
 <li>
-<a target="_blank" class="fork" href="http://jakarta.apache.org/commons/io/">Apache Jakarta Commons IO</a>, a library with I/O utilities.</li>
+<a class="external" href="http://jakarta.apache.org/commons/io/">Apache Jakarta Commons IO</a>, a library with I/O utilities.</li>
             
 <li>
-<a target="_blank" class="fork" href="http://excalibur.apache.org/framework/">Apache Excalibur/Avalon Framework</a>, for XML configuration handling.</li>
+<a class="external" href="http://excalibur.apache.org/framework/">Apache Excalibur/Avalon Framework</a>, for XML configuration handling.</li>
           
 </ul>
         
@@ -329,7 +339,7 @@
         the path to use in this case is <span class="codefrag">/Library/Java/Home</span>. <strong>Caveat:</strong>
         We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum 
         Java requirements, the two will inevitably not match on some systems. Please see 
-        <a href="http://developer.apple.com/java/faq">Java on Mac OSX FAQ</a> for information as 
+        <a class="external" href="http://developer.apple.com/java/faq">Java on Mac OSX FAQ</a> for information as 
         it becomes available.
       </p>
 <pre class="code">
@@ -407,7 +417,7 @@
   Fop foo.fo -awt</pre>
 <p>
         PDF encryption is only available if FOP was compiled with encryption support 
-        <strong>and</strong> if compatible encryption support is availabe at run time. 
+        <strong>and</strong> if compatible encryption support is available at run time. 
         Currently, only the JCE is supported. Check the <a href="pdfencryption.html">Details</a>.
       </p>
 <a name="N100C4"></a><a name="your-own-script"></a>
@@ -442,25 +452,25 @@
 <a name="N10103"></a><a name="dynamical-classpath"></a>
 <h3 class="underlined_5">FOP's dynamical classpath construction</h3>
 <p>If FOP is started without a proper classpath, it tries to
-		add its dependencies dynamically. If the system property
-		<span class="codefrag">fop.home</span> contains the name of a directory, then
-		FOP uses that directory as the base directory for its
-		search. Otherwise the current working directory is the base
-		directory. If the base directory is called <span class="codefrag">build</span>,
-		then its parent directory becomes the base directory.</p>
+          add its dependencies dynamically. If the system property
+          <span class="codefrag">fop.home</span> contains the name of a directory, then
+          FOP uses that directory as the base directory for its
+          search. Otherwise the current working directory is the base
+          directory. If the base directory is called <span class="codefrag">build</span>,
+          then its parent directory becomes the base directory.</p>
 <p>FOP expects to find <span class="codefrag">fop.jar</span> in the
-		<span class="codefrag">build</span> subdirectory of the base directory, and
-		adds it to the classpath. Subsequently FOP adds all
-		<span class="codefrag">jar</span> files in the lib directory to the
-		classpath. The lib directory is either the <span class="codefrag">lib</span>
-		subdirectory of the base directory, or, if that does not
-		exist, the base directory itself.</p>
+          <span class="codefrag">build</span> subdirectory of the base directory, and
+          adds it to the classpath. Subsequently FOP adds all
+          <span class="codefrag">jar</span> files in the lib directory to the
+          classpath. The lib directory is either the <span class="codefrag">lib</span>
+          subdirectory of the base directory, or, if that does not
+          exist, the base directory itself.</p>
 <p>If the system property <span class="codefrag">fop.optional.lib</span>
-		contains the name of a directory, then all <span class="codefrag">jar</span>
-		files in that directory are also added to the classpath. See
-		the methods <span class="codefrag">getJARList</span> and
-		<span class="codefrag">checkDependencies</span> in
-		<span class="codefrag">org.apache.fop.cli.Main</span>.</p>
+          contains the name of a directory, then all <span class="codefrag">jar</span>
+          files in that directory are also added to the classpath. See
+          the methods <span class="codefrag">getJARList</span> and
+          <span class="codefrag">checkDependencies</span> in
+          <span class="codefrag">org.apache.fop.cli.Main</span>.</p>
 </div>
     
 <a name="N10135"></a><a name="check-input"></a>
@@ -505,7 +515,7 @@
 </div>
 <p>
         The -foout option works the same way as if you would call the 
-        <a href="http://xml.apache.org/xalan-j/commandline.html">Xalan command-line</a>:
+        <a class="external" href="http://xml.apache.org/xalan-j/commandline.html">Xalan command-line</a>:
       </p>
 <p>
         
@@ -532,7 +542,7 @@
         
 <li>
           Increase memory available to the JVM. See 
-          <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/java.html">the -Xmx option</a> 
+          <a class="external" href="http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/java.html">the -Xmx option</a> 
           for more information.
           <div class="warning">
 <div class="label">Warning</div>
@@ -576,14 +586,9 @@
         </li>
       
 </ul>
-<p>
-        One of FOP's stated design goals is to be able to process input of arbitrary size.
-        Addressing this goal is one of the prime motivations behind the 
-        <a href="../dev/index.html">FOP Redesign</a>.
-      </p>
 </div>
     
-<a name="N10191"></a><a name="problems"></a>
+<a name="N1018A"></a><a name="problems"></a>
 <h2 class="underlined_10">Problems</h2>
 <div class="section">
 <p>If you have problems running FOP, please see the <a href="../gethelp.html">"How to get Help" page</a>.</p>

Modified: xmlgraphics/site/deploy/fop/trunk/running.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/running.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/running.pdf (original)
+++ xmlgraphics/site/deploy/fop/trunk/running.pdf Thu Aug 23 12:00:37 2007
@@ -8,7 +8,7 @@
 << /Length 950 /Filter [ /ASCII85Decode /FlateDecode ]
  >>
 stream
-Gb!$F>u03/'Sc)J.suoTEe,0Zjb#YI<f(P>(_gi8ZjRPq2Cr2\0!,)%G*9kCChb.gKp<&4E-fb"qOBM<q:qC`(nr"^BYJFjo.+idZucRooaa>Pe^$AG@cdi-StYV:X*(!]q=5An:d<<VS=Gj">/bYKqg<[JI\?KASXU`ggY=js76iO5Gan3d.Xk(VUrZ>K%`)6a;EI,.1\ups^Ld$Cp6aHDSBKZoq1jVHRM6,kNf%)\\Z5OS!YKW8?XWF4k2Xg,dh*Gp$n%jsK!.,@MDMm&<W''rW]4c1D'%Z&rA6!5Aj.2/kTDklZ/<CE6#mNaOk34&WDn0o?\e7qcpKT*0#;"TNq[BPE<R+>nV4b]7gAsXp3E!o"E"T2JsuuRZ^uO$VRP>7rj""qZXp>d]]I^Veo5s\C7T\QP7E6TeN+,Q<jGVo$atK?\DDBQCG<1arN5umVF;!=l)ZGb,W]>^kbZLHFcruF>2W`UASaaF_"aCF7hW32S;X,KP<,_,;?;QUm.aV]BEc,:(b7geD4.[AD;"D5'%*@24Z90C5lB4`fr^`<Ym0^:;uW[e0A0GsMQVN;F,3+2oMa.1Z*/jB.6p!T8@6$*M#nWG0-B9pcpoJX&dhXQctc*(fbnL&*.s,&m1l^(KF]O6j0aY-ik%o;1[PW#3522oY"K(DdO1L_c#X.RbY",Y&J`\q.e@rSP5FG^9814.bi>0d-0PM4f^[]r*;p#&f,me#TC)P#0@u!H)SMI+>".Wl8VH:Z;@H/!Jj74W;/Il;9eD\:2o?6s!T02q2or._``qp'#2)<3Is%pX\1%rt0+#C'Gs?KoRL<&8$R)YWcn=LL98e_-5ZNaYc55[!>dS/tOc'>,Erk]3PYi)8ZJHWUhp(Nd-`UXTi]I%qFu/7^en:oWFqb2rBWn+HqNXt?l#cbP9:(np=%QA$g#Tt<[@HNkp!aWR"uHhTWW~>
+Gb!$F>u03/'Sc)J.suoTEe,0Zjb#YI<f(...@L_7RVu0>U?F$hp'O:fTk7E8Dkbk/A@UBLc;Lj"2OD&p3&d:2m?9ZLjTT;k9,o!A,U">60Z89q+3!L++g+-:/#Tm"K`bQ*9`-7\UB%e2%E-t5g?'c2hUe`iGS*(?/R$B);,:]Fm<9Ef/-25eGQ3r8:RE%7S9$dsGYiE3n3;Nq*Y<SW&525m%?EOgn20pk5[>N<cOpKH>U_o=!"Fl<8U=r_TRp%ETDMBCo"26>lDie6HNORd-%C1WEs6<k:EDmor?P7h.np^!h1`*%O(.)78TO#i!QPLB9JZ9P=S1i0u\S0As+r:L6k5sGF.&/+OAA(-4^73gQ:K5;2`HV$lm:OQGXNsZ7m3iMocsB)ooIHc\e*6L+Q7a[jY*,a'ZH7`WC,sg_l_u3.%H>[uU]~>
 endstream
 endobj
 6 0 obj
@@ -413,10 +413,10 @@
 >>
 endobj
 56 0 obj
-<< /Length 2177 /Filter [ /ASCII85Decode /FlateDecode ]
+<< /Length 2175 /Filter [ /ASCII85Decode /FlateDecode ]
  >>
 stream
-GauHMgMYb*&:Ml+#^L+k1pff9\eISa2N<V1Rn^>2(Bp6k0K'qe.nclf47V4skWZAQ+SB?+U5hcA__Yr.U>A\+c6l,sNi7(*s$%QMN7aH^](!mK++?uh[u"m3b.9b4lfe:rb@-9T[]jT-;9*2.?Opa"/%`-BDgqLq))gE("+U.V7cV:Y2G?j-7s5'ZL4@_DH249*6)leF>2N+NAJ)p8X]*h(=.b094H'u5SRt3#9(o`P9I[V6>o!=BIe&7Oq7O*UpPCPlm2khsIj-O(OieJ4Pu=Pf:Vr"+]Ykq]"b\prkYu/7ffp@t-,R6Zd0^??<9(GYZ_Y?Bj_3a<ane<2Kdme*H;j8'(6d0R5>`.6<;**g@:$(Zbt4d1-.0U`StOqu!Rs_:(Btmt?>e`k8llWk5X]+an!@B/='m=>9[jG7+Dt#Z93+LA2Qk^jm_]<ur>#F[<'4*IRe8Hln#roYN%qZk8DTjABO3t%c7<LJ_aBuEruXLE0Hoi4^L#--#d;Xe!=?C[Xe`EQ^hn<Y+5kPY;nUX;=f,%Ej'kY3K<#@2-BtsAC0($CEdZ,30oG!7o/%-Bm5.HEL9=FI&2msVYI4cY&$QH[fEp9%G@)iaoA=)#(?T<V2ji"r7=.4Plkg[#GAJI,LWkWC396FJrXR&CpiI!+N=LL4lKjSFd6a8mgL?K2-Es"'0A%O'Y,>Ei(40PG'gZ%9jZG[+_sbTHqkE0Q-$C4g76!6<YPkPA-_JD*q_.[m@9r_jmge<kIt$/lX[e5s7U,CZ)uqQ91#/T>l="U,jt7sSD^G9n^+[C#qOo>?"3+Q%Br5nc(XRTi'Ug0%HE?_Vg3gNb-[4'oN!i85-4ocJ9uHc2JOrLR&lDp!UoC/X"*Z+JMNW<#I1u3-CpRggY>nVf7Pc4LP^#n6@L;X&6O8+t&t:&-<O6EoS3olp"\BJ1A`#9k8tF;co"#YI8pd%A-l,?G"_J!]_ZGJJ-<P<T&@JW\N3Y]3mr>771U0b
 RH>MYr1;[4M:,!&;`n+r#&$`[f6_'u02X\Gi632,sl/E\bgn`\Q;8\UBLa*sZd)qG`-dEeZ1k4dJAkZ-0VU-8WX(WMf/_c'42`It(^uRDG2&$:EH-emGK^%tQ;4&0?>E4dUn5?DHkDakSVF_du_lVt^FQW@W\8>1r_a?7q(SA'$2_JI_0'(@Tok_s]k!4.W2.:P)OK&^o(NM+Q'C^%Qb&F8\8R@+4Se9i4/8TCdDAV`NN!)krb`hZULT%s^*lpQ$,=[iM6gV8Yak)<HcOtrYp"u]Kk>=4VRd(mM%(p0&C3,0W`j$UCL>ric3LDOg6b)k0`ipKC[DnR]>!2N@?r)&J9&aMo2U8dI<2,:E`d(^be;U&TDkZ8j-ie3NK^*.0PQ_Qe)t$#el1f;?KHXeWQg;KI'IVYLUuc,<##*[c2dn4^FkVLmWKACV15t:r"qW)K9sVW9!IMc&1)`E\+/sC\41cB53o4:s'Aaf!1hf05*q1l/M.eji-g2QS]S+KBI9b;*K+*MKcS<L#h%kO]qOp/%^5pE>U5%sMn6*Y0PG-Q9Z9l$q0NR>1^_eH5B2V&P8r6K9cj`q0`Y/GX)YU(\f_#"6hhq-Y$3gL=+B1J>'D.GjhQ8,J-.5$ip(ZE4:J8jBeV$5_0*jL^g9,M]SKL*Ee_/b^36Vp+";)scg"EtuGcCn*`knH]\sU_7"AVBN>aoqm>%RCBe^H">At-/Q@;=r)][U1Fq6q7#<7<IkpXeHKX+#"@OdP\Z&5q^#h6)+h7pn/:=/VOsUDk#$37QL/X7Fmc*Sg7B]Cj+&44Tj@Qgf/iM'!X9:%Lk0S%*:e6R!dZRB;R@!pVf1LM*Xrl:2G'?4C&7:.3@bo@^Yl6.a+o=.*6%BI[,bn_$6'Ir<B3*bdeofu!L,01_%"c\9,/s!<Lg]AP@Qnj"\G>6<V%b]FL1XS9QAn#bpPbL3&nnuGbl#s5Btjp+ldWHj+*J!K<m7&roB)9hXXf6tag%V.
 tg63l)=OY<apY"LYT^Bm#h_/"6EV`!/`<9<k1*'d@7C3sM6<.@ZD:6dVHc.e:nF;og^XW?<(K!I3i#d36Z^)'9hF<BP!cTEVk^%)T!L@$+Id.YGb$2^`1T1h%S&*n29-Z1mA2:Bk?_HM!s`[GhT;7_bEIe6hY7J_<eJnf:la`J+iF!<,#,g#IDco-o1NrB3L+RQZ~>
+GauHMgMYb*&:Ml+#^L+k1pff9\eISa2N<V1Rn^>2(Bp6k0K'qe.nclf47V4skWZAQ+SB?+U5hcA__Yr.U>A\+c6l,sNi7(*s$%QMN7aH^](!mK++?uh[u"m3b.9b4lfe:rb@-9T[]jT-;9*2.?Opa"/%`-BDgqLq))gE("+U.V7cV:Y2G?j-7s5'ZL4@_DH249*6)leF>2N+NAJ)p8X]*h(=.b094H'u5SRt3#9(o`P9I[V6>o!=BIe&7Oq7O*UpPCPlm2khsIj-O(OieJ4Pu=Pf:Vr"+]Ykq]"b\prkYu/7ffp@t-,R6Zd0^??<9(GYZ_Y?Bj_3a<ane<2Kdme*H;j8'(6d0R5>`.6<;**g@:$(Zbt4d1-.0U`StOqu!Rs_:(Btmt?>e`k8llWk5X]+an!@B/='m=>9[jG7+Dt#Z93+LA2Qk^jm_]<ur>#F[<'4*IRe8Hln#roYN%qZk8DTjABO3t%c7<LJ_aBuEruXLE0Hoi4^L#--#d;Xe!=?C[Xe`EQ^hn<Y+5kPY;nUX;=f,%Ej'kY3K<#@2-BtsAC0($CEdZ,30oG!7o/%-Bm5.HEL9=FI&2msVYI4cY&$QH[fEp9%G@)iaoA=)#(?T<V2ji"r7=.4Plkg[#GAJI,LWkWC396FJrXR&CpiI!+N=LL4lKjSFd6a8mgL?K2-Es"'0A%O'Y,>Ei(40PG'gZ%9jZG[+_sbTHqkE0Q-$C4g76!6<YPkPA-_JD*q_.[m@9r_jmge<kIt$/lX[e5s7U,CZ)uqQ91#/T>l="U,jt7sSD^G9n^+[C#qOo>?"3+Q%Br5nc(XRTi'Ug0%HE?_Vg3gNb-[4'oN!i85-4ocJ9uHc2JOrLR&lDp!UoC/X"*Z+JMNW<#I1u3-CpRggY>nVf7Pc4LP^#n6@L;X&6O8+t&t:&-<O6EoS3olp"\BJ1A`#9k8tF;co"#YI8pd%A-l,?G"_J!]_ZGJJ-<P<T&@JW\N3Y]3mr>771U0b
 RH>MYr1;[4M:,!&;`n+r#&$`[f6_'u02X\Gi632,sl/E\bgn`\Q;8\UBLa*sZd)qG`-dEeZ1k4dJAkZ-0VU-8WX(WMf/_c'42`It(^uRDG2&$:EH-emGK^%tQ;4&0?>E4dUn5?DHkDakSVF_du_lVt^FQW@W\8>1r_a?7q(SA'$2_JI_0'(@Tok_s]k!4.W2.:P)OK&^o(NM+Q'C^%Qb&F8\8R@+4Se9i4/8TCdDAV`NN!)krb`hZULT%s^*lpQ$,=[iM6gV8Yak)<Hc...@gVrMJ2Tra>A#dC'L<VcHQp35'FQ^e1*ge_-3,M(2E\e97HP)o:<u=^0c=U@[)0kr,qj38JM")LN/C\;F0.Pq"A*mRttIc&)M_Q?.Y^7#/uk"Xh%E_M+'*_Vug)G)f5;U<4=5Y9fgm6Q;>$Y9KmG=-$g
 8/YVqPi=iGAdZPb_ti409Q]2L_lamQ#Ua%,1jMOIAr.iY2YHWkQnS1/71ISHTl&-Qh:pl6)R[@om*-1CK>3)ZII)Fo2;5m?\AB>???#H<BbDk9\Y<u(UCRR)F*a(%8P]BQM]L40rjR_(7CM<g)JD>a+.hkDOIf:rqBMn;Z[Mf>*u=U?9DFuP#eER](%0-8.$,Q~>
 endstream
 endobj
 57 0 obj
@@ -616,10 +616,10 @@
 >>
 endobj
 77 0 obj
-<< /Length 2360 /Filter [ /ASCII85Decode /FlateDecode ]
+<< /Length 2147 /Filter [ /ASCII85Decode /FlateDecode ]
  >>
 stream
-GatU5968iG&AII3E,o[JM.,pKp6JD4,b7]tVX!eMpAddHL^?X,,\4sooj*BW"[kn'RS71S_EP\>m'dAdh.lJ/[J7=PSNZoJY_YHJFJ:18s+;_Ns0'+X8Kt'Ec?f$Xin^hd8^bCsj5Hn7n"$H0T0G:CcnHm@Q%<^0+Gm'2bUh_6U])=B-)hLbQc*rMprs7PRGBlkd.:QreG=BRC&LtnUX78&kbq=ZG)PH:9M3ZS;ZA-[Ok>_b<T3lS]&EOLn+_X'14R#id"P*^lR!EDX<*ua<prF^cuR%FQ1L'Cq?9R&NpF)2HMq\1r$ClsT[j)#H/TkWSd;\W5Tj3Q!cK.ahi<H-l4^;IMjj$8c+oBpN%],:X2]@jB'0t$JH?r$ZoY*_M[$<Fp`t%(7Yb!akJiUt%c:<'%L"@/o)ASH>#[NUKU82+Y[uJH*^,dD@ZC?>E(M>l-.;:InP*W2SOTVYgBDdFLTQ(P1H#PZ)3CMHfXp_ZM:&^8&BAT38dPO7R?E<@raF(F]I\?=[mn.4[1>(aJX5'^!S-g#RuA*9m`:VsVpN?2-!h,\,]T:M;Fm82dtj\7=lH2GAWLn[oC0?_Z6PB@Qm<`7Rg7^a_,!:UJr\o>+#^"b!<cL/&.6I=6K1?!p2=s_8Aa#)ErKa/`N$-%dUQNO]dP_@g5sX'c#?(]QCN/9NmbjF)Fl%Z'"cQmdNFDirAGaX@7OHqcWd!91c:OFlHP_6%<)MK"@qjo\TeNM?omu+S"?>':f0JnMod`CK4b`aGZK$h\%fZB0]=oLW^Ws1Y,3,[7(pX_d?gWT<#aN;6\?kQk,@@1_n'8`%pHdfV2i*3NV$a4hbFhO_$X&7k'\X(cRjN!3/mefFc-p#UL<H82/>VZaL6n.3FQHiI@YSS\BHQcMEnM<l!28+ggI5ab940_3uL]l%Ge9h(\Du6'fDeKf@[G&ZNZ)Zbnh(mo`9E#q#4D9/<e5J8Z?hZC<sP;KK0M<2=>e3@*WG<*hi*
 ^I&kKqe(m1ZPHh`$U1sCkk?MK64.IU'n<3'3KB<63jfL6Ubaf.b`OH9IUf9A1fTL:To.Bf(LbAq6^J&PH0?!h%Oc1KT!_'/?E2/J5iG*^iiP>WV]@b6!e?Zu0QeM_%MH8FNW(2X2oViQ0*0la5d@DB<6e<XC91J\Q]sWgg3N[;Go0Vsfg7bUIfS0K&U3(B<9'?qj2OY*"E=0/6WC4AbP>t8tCmeM"W./<ico:XI((/K#UeAq]ZkOX8E^HfVLVoIIQ4\UINN=!LckKdooQ5G(Y;70PP-fTp6B,W'35J0+HBUQ-,92S5GDAt[8W\Vh:fHsUL-$%0,u1A'*ZP*^V=q<.-4l3D^h(FS*C9oqeilP"K0t>MqFToP]$OJi5A#lC1\l!Ddk)o/6\tqZi.k8h-J.4<()<'RUP6(0o-B>3$4jN>l=,/G@7&t?e7T>i,H:Wua-5ME94$`2(>Y!$`c:nD*\EIm)Fj7Mk.3Fq;?d`X,=d(%UPh2jLdk..SdtbB\<U:_7NV&5D#tLp5IR:C@X,S8^/dJ+%>A^8k]Y-LWF7;h79ZA[hFK?4=sL@p_7gW)N$:Z*L.f+3Y=3ApEGb&"`lPt)be0**lbPQkXjh2?:'AC-7g;kd!g!o_-Pt3OiGa.!LR$mjfau'<Z-<,&)CtchZnN4o_[jg$@$Onk@d8tjI,57"2q*,peq`l(8\;X7"dGm-;,A9LG>n1'bF7GHV<A^kA_ZU7WcU!Xfn+'W&q=F+KkVHgYXM8^HHgG<'LM@\o1!N?16/nSS5j3l/=/'ALClN5ouC(Y-P7=!q`!DXd4siR_)Sa\>fR73P[i*da6"e09Vo!eHnV`T*<6PC#gd58n)9IooV`V/+59l`\A:T1njAIkr=*k%2W0!8@&k*'*l"M'Qpb7#W,$]4%GWiRedkb#>$F9X]I<'[)K<<8ErDI.oL4B#qfog;&eD+:C9XfWOAQY"Ld'M;FW#VW2LQ*Zi7N[%\HuIHFcT.ch_]
 @1He7%Y#?cm_f%bpHZ.^9#oTRYf?[QK@$sL\J]_\QZO6=*NH_K4%caku(ASA"Ne\,F$<B5...@m>"l,^3&PE=^UP@E,kY*X;W5&s:9P;J:^kk>hJZu(&4AMu2\iMap'=6$Mp7>O:/IG*gZg.qfi[53<iNHKlI(ch%;>=O<#!JuR;[KhF;fLc2Fic^dERiHPY$UZ9]^:J$ZIF4WCgYWUUA2q#2PDfb=*[RM#2i0WpR?Z5t2`KWOHsb>Pj-teMUEUoIrQS):2e.C;"''.4Zi~>
+GatU5968iG&AII3E."rQ0eGQip?#'/,b7]tVX!eMpAe'PL^?X,,\4sooj*@f\U[8.DW?R"K%S,QMg`G1=,RTi`OCQam,7oa"nCEF'?;j*%V#j\YPfkmIAc5QHL]bLID:3p-DBUbrmRijcIh]SO3SqP%SQsVi7\QEC@b]AnIkg]qWGYR-CQJhJp7g?Gu75@4[g%[rnE95r=1ZdI[Y:"]"*_=D2QkeYrnCF'7*Cd*2m>5"L59_SA-ZqYq*doUo[PkbEXuVApi:mnsS+IF2dIIX:&(+gq@b-G#gh[#g`&=<lU8Ol\]*7"uL/l5PfiY'1B#0=r9LiQQ<p0P8'KP0M$V(2-QsSQId,KB\[%dDL0p=`bKsKK9F:UZ9Z$CV@77E=q+8JMe$p39mdu_pN?6h1>NbZ<(QlshcWh<=;+Q/q0p5d`#X.RpVe':P7#9nO<roUS;B)/i/T&4XJZB615DWT-o4$oE>c@H&`QZYGDM3[%=m)CW@Sc$"FEaD!fmk-^(Y',b2&ldO'dr[7QRboF5!8kh^6Tm@@W?OX7[BWP^'?\K`9,6LAFLlQ;>+)6a=9JapFA(SAWM0AZ'++30k/Q4sW'/Ea&sE!K"]HaTV\bbeOGhYRM]h:(Tpu#I/V\aant3`-HNTD\L;>^Fkioln\'!VR^A75$'U7&Zls7XkFble7M<^Q\KUNBb.0j7?Dth&''j.,q#T:cXE9p9W;>Y@A=l=:Q")oo/@JH,mZmdrb9b9Qs)$J-uHn.`cLYAU^5<3IWbP27>D29_1=2lrHL2#:e'H8d"<qUU9QJ:Z@.?LPiX=SS,KqWhtBOT>+psto,@/@GeP%k#R)klNJdJE<$IsU(VR[fhpR`KJiO<r$=36mk"gAW;QFcI4&<SYGFsT3c7+W9o:2;\:*@0b?3udGBJ[+R(]bP#6`D]jbIB';E1s58B'Yci(lC1XOeL?QX?F`#060;)WU.,m7V-&XSsN7"Va8#9<=]D[3GZtd']);
 qN4r]4\jlcAWd?%]7]]$2'Ge@#?4qr?RAi#^/s':TXk$ltB)jR(;.)G]b#pdeP_Yn!cjM;;(9IKrIK]QSfCMIOL3Q=$XTH_+?K&[Wc2bnE#KCtrP!c0Zqs?;6C+(Q4)1A/l*O[i;<bQ...@eDc>FMSqo>h)UlE)tD6Bll4\q+9HmUW.sJ>KF3ZS]LD!N5_M#WV"=pmBVVjT1+ma<HG%,_QD;ME6pfDmK<#nPf3sjY'ngR:R'_Tn&mGa3#KhF:2Eo$7]&YI5)+M`0eGd8N8[6U,W:J%Ch6nib\:+C-2COrIOZfDJDQI!`8jr96,<MgNfb5:D6V\Qg%fX\jA8YtXg>cma";br?2R9]+GeJR:et9s5_RBkgZOo7JYS9/C-_LYBOC5N)Oj$Q<qj\fcL(LII%d=bC@D,YfN4.>Q,C;/lo-ss@#NHLsTg#=4L_7:1a?[=:J>@hiaebH9E4EO#c,u`VCke#rNYd_/>X2dX3Sp4Da9iHcKEe;ebh7hrisgur''cMd57,#H8tLF0B:r9@N#6OS+0RK6mV^@`bs[nj5tpcsh_T.7a-&b^(58ne>"#!\HI7[7@INhrqfB$O/n?(bTG(\sT$qYW*H-!H:@LmB;c#MoQUD@S+iHY,*uFq:9h!BN0ZD!YIGm%b/Q3%Z<ch6A3@lD5AYec]kTn=m9M[Wu;0"i7;iI#8:Wf6GP$0EYBrCW#HGT[i$pnmBDmA+brjQ*fjVI%\i(JG=$[M-*:Jg.+AtuUVC!l";kW(2N`R7Oe&tJ^?5WGE&2g`P%9@%Y23ojH$JYDX7:*O$&H@F:[r\EOM6JR745"p
 tO9A=d?0-/aYA4f\W^rlg[8^q<?YX2muJ]&LmT7egCSbRuC'_R%`;VkWd)&:?u8N]>DI43A`MhV5MlSu<$VnP0C64"*rC+FJ>d!!IsG6F!#Xd2i]Hq<]\NO69]FSmqkWZQ.s^)-UJAlU2+`aoBEY,lh+>?Tbj#5T,A]fl2~>
 endstream
 endobj
 78 0 obj
@@ -637,7 +637,6 @@
 81 0 R
 82 0 R
 83 0 R
-84 0 R
 ]
 endobj
 80 0 obj
@@ -654,18 +653,7 @@
 81 0 obj
 << /Type /Annot
 /Subtype /Link
-/Rect [ 301.656 391.4 371.328 379.4 ]
-/C [ 0 0 0 ]
-/Border [ 0 0 0 ]
-/A << /URI (../dev/index.html)
-/S /URI >>
-/H /I
->>
-endobj
-82 0 obj
-<< /Type /Annot
-/Subtype /Link
-/Rect [ 314.628 328.066 429.732 316.066 ]
+/Rect [ 314.628 362.466 429.732 350.466 ]
 /C [ 0 0 0 ]
 /Border [ 0 0 0 ]
 /A << /URI (../gethelp.html)
@@ -673,7 +661,7 @@
 /H /I
 >>
 endobj
-83 0 obj
+82 0 obj
 << /Type /Annot
 /Subtype /Link
 /Rect [ 232.25 683.0 361.75 673.0 ]
@@ -684,7 +672,7 @@
 /H /I
 >>
 endobj
-84 0 obj
+83 0 obj
 << /Type /Annot
 /Subtype /Link
 /Rect [ 221.685 671.75 372.315 661.75 ]
@@ -695,145 +683,145 @@
 /H /I
 >>
 endobj
-86 0 obj
+85 0 obj
 <<
  /Title (\376\377\0\61\0\40\0\123\0\171\0\163\0\164\0\145\0\155\0\40\0\122\0\145\0\161\0\165\0\151\0\162\0\145\0\155\0\145\0\156\0\164\0\163)
- /Parent 85 0 R
- /Next 87 0 R
+ /Parent 84 0 R
+ /Next 86 0 R
  /A 9 0 R
 >> endobj
-87 0 obj
+86 0 obj
 <<
  /Title (\376\377\0\62\0\40\0\111\0\156\0\163\0\164\0\141\0\154\0\154\0\141\0\164\0\151\0\157\0\156)
- /Parent 85 0 R
- /First 88 0 R
- /Last 89 0 R
- /Prev 86 0 R
- /Next 90 0 R
+ /Parent 84 0 R
+ /First 87 0 R
+ /Last 88 0 R
+ /Prev 85 0 R
+ /Next 89 0 R
  /Count -2
  /A 11 0 R
 >> endobj
-88 0 obj
+87 0 obj
 <<
  /Title (\376\377\0\62\0\56\0\61\0\40\0\111\0\156\0\163\0\164\0\162\0\165\0\143\0\164\0\151\0\157\0\156\0\163)
- /Parent 87 0 R
- /Next 89 0 R
+ /Parent 86 0 R
+ /Next 88 0 R
  /A 13 0 R
 >> endobj
-89 0 obj
+88 0 obj
 <<
  /Title (\376\377\0\62\0\56\0\62\0\40\0\120\0\162\0\157\0\142\0\154\0\145\0\155\0\163)
- /Parent 87 0 R
- /Prev 88 0 R
+ /Parent 86 0 R
+ /Prev 87 0 R
  /A 15 0 R
 >> endobj
-90 0 obj
+89 0 obj
 <<
  /Title (\376\377\0\63\0\40\0\123\0\164\0\141\0\162\0\164\0\151\0\156\0\147\0\40\0\106\0\117\0\120\0\40\0\141\0\163\0\40\0\141\0\40\0\123\0\164\0\141\0\156\0\144\0\141\0\154\0\157\0\156\0\145\0\40\0\101\0\160\0\160\0\154\0\151\0\143\0\141\0\164\0\151\0\157\0\156)
- /Parent 85 0 R
- /First 91 0 R
- /Last 94 0 R
- /Prev 87 0 R
- /Next 95 0 R
+ /Parent 84 0 R
+ /First 90 0 R
+ /Last 93 0 R
+ /Prev 86 0 R
+ /Next 94 0 R
  /Count -4
  /A 17 0 R
 >> endobj
-91 0 obj
+90 0 obj
 <<
  /Title (\376\377\0\63\0\56\0\61\0\40\0\125\0\163\0\151\0\156\0\147\0\40\0\164\0\150\0\145\0\40\0\146\0\157\0\160\0\40\0\163\0\143\0\162\0\151\0\160\0\164\0\40\0\157\0\162\0\40\0\142\0\141\0\164\0\143\0\150\0\40\0\146\0\151\0\154\0\145)
- /Parent 90 0 R
- /Next 92 0 R
+ /Parent 89 0 R
+ /Next 91 0 R
  /A 19 0 R
 >> endobj
-92 0 obj
+91 0 obj
 <<
  /Title (\376\377\0\63\0\56\0\62\0\40\0\127\0\162\0\151\0\164\0\151\0\156\0\147\0\40\0\171\0\157\0\165\0\162\0\40\0\157\0\167\0\156\0\40\0\163\0\143\0\162\0\151\0\160\0\164)
- /Parent 90 0 R
- /Prev 91 0 R
- /Next 93 0 R
+ /Parent 89 0 R
+ /Prev 90 0 R
+ /Next 92 0 R
  /A 21 0 R
 >> endobj
-93 0 obj
+92 0 obj
 <<
  /Title (\376\377\0\63\0\56\0\63\0\40\0\122\0\165\0\156\0\156\0\151\0\156\0\147\0\40\0\167\0\151\0\164\0\150\0\40\0\152\0\141\0\166\0\141\0\47\0\163\0\40\0\55\0\152\0\141\0\162\0\40\0\157\0\160\0\164\0\151\0\157\0\156)
- /Parent 90 0 R
- /Prev 92 0 R
- /Next 94 0 R
+ /Parent 89 0 R
+ /Prev 91 0 R
+ /Next 93 0 R
  /A 23 0 R
 >> endobj
-94 0 obj
+93 0 obj
 <<
  /Title (\376\377\0\63\0\56\0\64\0\40\0\106\0\117\0\120\0\47\0\163\0\40\0\144\0\171\0\156\0\141\0\155\0\151\0\143\0\141\0\154\0\40\0\143\0\154\0\141\0\163\0\163\0\160\0\141\0\164\0\150\0\40\0\143\0\157\0\156\0\163\0\164\0\162\0\165\0\143\0\164\0\151\0\157\0\156)
- /Parent 90 0 R
- /Prev 93 0 R
+ /Parent 89 0 R
+ /Prev 92 0 R
  /A 25 0 R
 >> endobj
-95 0 obj
+94 0 obj
 <<
  /Title (\376\377\0\64\0\40\0\125\0\163\0\151\0\156\0\147\0\40\0\130\0\141\0\154\0\141\0\156\0\40\0\164\0\157\0\40\0\103\0\150\0\145\0\143\0\153\0\40\0\130\0\123\0\114\0\55\0\106\0\117\0\40\0\111\0\156\0\160\0\165\0\164)
- /Parent 85 0 R
- /Prev 90 0 R
- /Next 96 0 R
+ /Parent 84 0 R
+ /Prev 89 0 R
+ /Next 95 0 R
  /A 27 0 R
 >> endobj
-96 0 obj
+95 0 obj
 <<
  /Title (\376\377\0\65\0\40\0\115\0\145\0\155\0\157\0\162\0\171\0\40\0\125\0\163\0\141\0\147\0\145)
- /Parent 85 0 R
- /Prev 95 0 R
- /Next 97 0 R
+ /Parent 84 0 R
+ /Prev 94 0 R
+ /Next 96 0 R
  /A 29 0 R
 >> endobj
-97 0 obj
+96 0 obj
 <<
  /Title (\376\377\0\66\0\40\0\120\0\162\0\157\0\142\0\154\0\145\0\155\0\163)
- /Parent 85 0 R
- /Prev 96 0 R
+ /Parent 84 0 R
+ /Prev 95 0 R
  /A 31 0 R
 >> endobj
-98 0 obj
+97 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
-99 0 obj
+98 0 obj
 << /Type /Font
 /Subtype /Type1
 /Name /F5
 /BaseFont /Times-Roman
 /Encoding /WinAnsiEncoding >>
 endobj
-100 0 obj
+99 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F6
-/BaseFont /Times-Italic
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
-101 0 obj
+100 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F2
+/BaseFont /Helvetica-Oblique
 /Encoding /WinAnsiEncoding >>
 endobj
-102 0 obj
+101 0 obj
 << /Type /Font
 /Subtype /Type1
 /Name /F9
 /BaseFont /Courier
 /Encoding /WinAnsiEncoding >>
 endobj
-103 0 obj
+102 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F2
-/BaseFont /Helvetica-Oblique
+/Name /F6
+/BaseFont /Times-Italic
 /Encoding /WinAnsiEncoding >>
 endobj
-104 0 obj
+103 0 obj
 << /Type /Font
 /Subtype /Type1
 /Name /F7
@@ -848,13 +836,13 @@
 2 0 obj
 << /Type /Catalog
 /Pages 1 0 R
- /Outlines 85 0 R
+ /Outlines 84 0 R
  /PageMode /UseOutlines
  >>
 endobj
 3 0 obj
 << 
-/Font << /F3 98 0 R /F5 99 0 R /F1 101 0 R /F6 100 0 R /F9 102 0 R /F2 103 0 R /F7 104 0 R >> 
+/Font << /F1 97 0 R /F5 98 0 R /F3 99 0 R /F2 100 0 R /F9 101 0 R /F6 102 0 R /F7 103 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -926,48 +914,48 @@
 31 0 obj
 <<
 /S /GoTo
-/D [78 0 R /XYZ 67.0 368.4 null]
+/D [78 0 R /XYZ 67.0 402.8 null]
 >>
 endobj
-85 0 obj
+84 0 obj
 <<
- /First 86 0 R
- /Last 97 0 R
+ /First 85 0 R
+ /Last 96 0 R
 >> endobj
 xref
-0 105
+0 104
 0000000000 65535 f 
-0000030470 00000 n 
-0000030570 00000 n 
-0000030662 00000 n 
+0000030080 00000 n 
+0000030180 00000 n 
+0000030272 00000 n 
 0000000015 00000 n 
 0000000071 00000 n 
 0000001112 00000 n 
 0000001232 00000 n 
 0000001348 00000 n 
-0000030812 00000 n 
+0000030421 00000 n 
 0000001480 00000 n 
-0000030875 00000 n 
+0000030484 00000 n 
 0000001614 00000 n 
-0000030941 00000 n 
+0000030550 00000 n 
 0000001750 00000 n 
-0000031007 00000 n 
+0000030616 00000 n 
 0000001886 00000 n 
-0000031073 00000 n 
+0000030682 00000 n 
 0000002022 00000 n 
-0000031137 00000 n 
+0000030746 00000 n 
 0000002158 00000 n 
-0000031203 00000 n 
+0000030812 00000 n 
 0000002294 00000 n 
-0000031267 00000 n 
+0000030876 00000 n 
 0000002430 00000 n 
-0000031333 00000 n 
+0000030942 00000 n 
 0000002566 00000 n 
-0000031399 00000 n 
+0000031008 00000 n 
 0000002702 00000 n 
-0000031465 00000 n 
+0000031074 00000 n 
 0000002838 00000 n 
-0000031530 00000 n 
+0000031139 00000 n 
 0000002974 00000 n 
 0000003156 00000 n 
 0000003342 00000 n 
@@ -993,60 +981,59 @@
 0000012216 00000 n 
 0000012398 00000 n 
 0000012584 00000 n 
-0000014854 00000 n 
-0000014977 00000 n 
-0000015018 00000 n 
-0000015185 00000 n 
-0000015367 00000 n 
-0000015553 00000 n 
-0000018084 00000 n 
-0000018207 00000 n 
-0000018248 00000 n 
-0000018386 00000 n 
-0000018568 00000 n 
-0000018754 00000 n 
-0000021962 00000 n 
-0000022085 00000 n 
-0000022147 00000 n 
-0000022319 00000 n 
-0000022493 00000 n 
-0000022691 00000 n 
-0000022905 00000 n 
-0000023087 00000 n 
-0000023273 00000 n 
-0000025726 00000 n 
-0000025849 00000 n 
-0000025904 00000 n 
-0000026073 00000 n 
-0000026240 00000 n 
-0000026409 00000 n 
-0000026591 00000 n 
-0000031594 00000 n 
-0000026777 00000 n 
-0000026981 00000 n 
-0000027199 00000 n 
-0000027373 00000 n 
-0000027523 00000 n 
-0000027904 00000 n 
-0000028204 00000 n 
-0000028455 00000 n 
-0000028751 00000 n 
-0000029077 00000 n 
-0000029375 00000 n 
-0000029552 00000 n 
-0000029692 00000 n 
-0000029805 00000 n 
-0000029915 00000 n 
-0000030027 00000 n 
-0000030136 00000 n 
-0000030243 00000 n 
-0000030360 00000 n 
+0000014852 00000 n 
+0000014975 00000 n 
+0000015016 00000 n 
+0000015183 00000 n 
+0000015365 00000 n 
+0000015551 00000 n 
+0000018082 00000 n 
+0000018205 00000 n 
+0000018246 00000 n 
+0000018384 00000 n 
+0000018566 00000 n 
+0000018752 00000 n 
+0000021960 00000 n 
+0000022083 00000 n 
+0000022145 00000 n 
+0000022317 00000 n 
+0000022491 00000 n 
+0000022689 00000 n 
+0000022903 00000 n 
+0000023085 00000 n 
+0000023271 00000 n 
+0000025511 00000 n 
+0000025634 00000 n 
+0000025682 00000 n 
+0000025851 00000 n 
+0000026020 00000 n 
+0000026202 00000 n 
+0000031203 00000 n 
+0000026388 00000 n 
+0000026592 00000 n 
+0000026810 00000 n 
+0000026984 00000 n 
+0000027134 00000 n 
+0000027515 00000 n 
+0000027815 00000 n 
+0000028066 00000 n 
+0000028362 00000 n 
+0000028688 00000 n 
+0000028986 00000 n 
+0000029163 00000 n 
+0000029303 00000 n 
+0000029411 00000 n 
+0000029521 00000 n 
+0000029634 00000 n 
+0000029751 00000 n 
+0000029858 00000 n 
+0000029970 00000 n 
 trailer
 <<
-/Size 105
+/Size 104
 /Root 2 0 R
 /Info 4 0 R
 >>
 startxref
-31645
+31254
 %%EOF

Added: xmlgraphics/site/deploy/fop/trunk/running.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/running.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/running.xml (added)
+++ xmlgraphics/site/deploy/fop/trunk/running.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,344 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+--><!-- $Id$ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document>
+  <header>
+    <title>Running Apache FOP</title>
+    <version>$Revision: 569104 $</version>
+  </header>
+
+  <body>
+    <section id="require">
+      <title>System Requirements</title>
+      <p>The following software must be installed:</p>
+      <ul>
+        <li>Java 1.3.x or later Runtime Environment.</li>
+        <li>
+          Apache FOP. The <link href="../download.html">FOP distribution</link> includes all libraries that you will 
+          need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These 
+          libraries include the following:
+          <ul>
+            <li>
+              A JAXP-compatible XML Parser (FOP comes with <link class="fork" href="ext:xerces">Apache Xerces-J</link>).
+            </li>
+            <li>
+              A JAXP-compatible XSLT Processor (FOP comes with <link class="fork" href="ext:xalan">Apache Xalan-J</link>).
+            </li>
+            <li><link class="fork" href="ext:batik">Apache Batik</link>, an SVG library.</li>
+            <li><link class="fork" href="ext:jakarta/commons/logging">Apache Jakarta Commons Logging</link>, a logger abstraction kit.</li>
+            <li><link class="fork" href="ext:jakarta/commons/io">Apache Jakarta Commons IO</link>, a library with I/O utilities.</li>
+            <li><link class="fork" href="ext:excalibur/framework">Apache Excalibur/Avalon Framework</link>, for XML configuration handling.</li>
+          </ul>
+        </li>
+      </ul>
+      <p>The following software is optional, depending on your needs:</p>
+      <ul>
+        <li>
+          Graphics libraries. Generally, FOP contains direct support for the most important
+          bitmap image formats (including PNG, TIFF, JPEG and GIF). If you're using JDK 1.3, 
+          you may need additional packages to get GIF images to work. See 
+          <link href="graphics.html">FOP: Graphics Formats</link> for details.
+        </li>
+        <li>
+          PDF encryption. See <link href="pdfencryption.html">FOP: PDF Encryption</link> for details.
+        </li>
+      </ul>
+      <p>In addition, the following system requirements apply:</p>
+      <ul>
+        <li>
+          If you will be using FOP to process SVG, you must do so in a graphical environment. 
+          See <link href="graphics.html#batik">FOP: Graphics (Batik)</link> for details.
+        </li>
+      </ul>
+    </section>
+    <section id="install">
+      <title>Installation</title>
+      <section id="install-instruct">
+        <title>Instructions</title>
+        <p>
+          Basic FOP installation consists of first unzipping the <code>.gz</code> file that is the 
+          distribution medium, then unarchiving the resulting <code>.tar</code> file in a 
+          directory/folder that is convenient on your system. Please consult your operating system 
+          documentation or Zip application software documentation for instructions specific to your 
+          site.
+        </p>
+      </section>
+      <section id="install-problems">
+        <title>Problems</title>
+        <p>
+          Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip 
+          and unarchive their distribution media. This is a legacy of older Mac operating systems, 
+          which had a 31-character pathname limit. Several Mac OSX users have recommended that 
+          Mac OSX users use the shell command <code>tar -xzf</code> instead.
+        </p>
+      </section>
+    </section>
+    <section id="standalone-start">
+      <title>Starting FOP as a Standalone Application</title>
+      <section id="fop-script">
+        <title>Using the fop script or batch file</title>
+      <p>
+        The usual and recommended practice for starting FOP from the command line is to run the 
+        batch file fop.bat (Windows) or the shell script fop (Unix/Linux).
+        These scripts require that the environment variable JAVA_HOME be 
+        set to a path pointing to the appropriate Java installation on your system. Macintosh OSX 
+        includes a Java environment as part of its distribution. We are told by Mac OSX users that 
+        the path to use in this case is <code>/Library/Java/Home</code>. <strong>Caveat:</strong>
+        We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum 
+        Java requirements, the two will inevitably not match on some systems. Please see 
+        <link href="http://developer.apple.com/java/faq">Java on Mac OSX FAQ</link> for information as 
+        it becomes available.
+      </p>
+      <source xml:space="preserve"><![CDATA[
+USAGE
+Fop [options] [-fo|-xml] infile [-xsl file] [-awt|-pdf|-mif|-rtf|-tiff|-png|-pcl|-ps|-txt|-at [mime]|-print] <outfile>
+ [OPTIONS]  
+  -d                debug mode   
+  -x                dump configuration settings  
+  -q                quiet mode  
+  -c cfg.xml        use additional configuration file cfg.xml
+  -l lang           the language to use for user information 
+  -r                relaxed/less strict validation (where available)
+  -dpi xxx          target resolution in dots per inch (dpi) where xxx is a number
+  -s                for area tree XML, down to block areas only
+  -v                to show FOP version being used
+
+  -o [password]     PDF file will be encrypted with option owner password
+  -u [password]     PDF file will be encrypted with option user password
+  -noprint          PDF file will be encrypted without printing permission
+  -nocopy           PDF file will be encrypted without copy content permission
+  -noedit           PDF file will be encrypted without edit content permission
+  -noannotations    PDF file will be encrypted without edit annotation permission
+  -pdfprofile prof  PDF file will be generated with the specified profile
+                    (Examples for prof: PDF/A-1b or PDF/X-3:2003)
+
+ [INPUT]  
+  infile            xsl:fo input file (the same as the next) 
+  -fo  infile       xsl:fo input file  
+  -xml infile       xml input file, must be used together with -xsl 
+  -atin infile      area tree input file 
+  -xsl stylesheet   xslt stylesheet 
+ 
+  -param name value <value> to use for parameter <name> in xslt stylesheet
+                    (repeat '-param name value' for each parameter)
+ 
+ [OUTPUT] 
+  outfile           input will be rendered as PDF into outfile
+  -pdf outfile      input will be rendered as PDF (outfile req'd)
+  -pdfa1b outfile   input will be rendered as PDF/A-1b compliant PDF
+                    (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b")
+  -awt              input will be displayed on screen 
+  -rtf outfile      input will be rendered as RTF (outfile req'd)
+  -pcl outfile      input will be rendered as PCL (outfile req'd) 
+  -ps outfile       input will be rendered as PostScript (outfile req'd) 
+  -afp outfile      input will be rendered as AFP (outfile req'd)
+  -tiff outfile     input will be rendered as TIFF (outfile req'd)
+  -png outfile      input will be rendered as PNG (outfile req'd)
+  -txt outfile      input will be rendered as plain text (outfile req'd) 
+  -at [mime] out    representation of area tree as XML (outfile req'd) 
+                    specify optional mime output to allow AT to be converted
+                    to final format later
+  -print            input file will be rendered and sent to the printer 
+                    see options with "-print help" 
+  -out mime outfile input will be rendered using the given MIME type
+                    (outfile req'd) Example: "-out application/pdf D:\out.pdf"
+                    (Tip: "-out list" prints the list of supported MIME types)
+  -mif outfile      input will be rendered as MIF (FrameMaker) (outfile req'd)
+                    Experimental feature - requires additional fop-sandbox.jar.
+  -svg outfile      input will be rendered as an SVG slides file (outfile req'd) 
+                    Experimental feature - requires additional fop-sandbox.jar.
+
+  -foout outfile    input will only be XSL transformed. The intermediate 
+                    XSL-FO file is saved and no rendering is performed. 
+                    (Only available if you use -xml and -xsl parameters)
+
+
+ [Examples]
+  Fop foo.fo foo.pdf 
+  Fop -fo foo.fo -pdf foo.pdf (does the same as the previous line)
+  Fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf
+  Fop -xml foo.xml -xsl foo.xsl -foout foo.fo
+  Fop foo.fo -mif foo.mif
+  Fop foo.fo -rtf foo.rtf
+  Fop foo.fo -print or Fop -print foo.fo 
+  Fop foo.fo -awt]]></source>
+      <p>
+        PDF encryption is only available if FOP was compiled with encryption support 
+        <strong>and</strong> if compatible encryption support is available at run time. 
+        Currently, only the JCE is supported. Check the <link href="pdfencryption.html">Details</link>.
+      </p>
+      </section>
+      <section id="your-own-script">
+        <title>Writing your own script</title>
+        <p>FOP's entry point for your own scripts is the class
+<code>org.apache.fop.cli.Main</code>. The general pattern for the
+        command line is: <code>java -classpath &lt;CLASSPATH&gt;
+        org.apache.fop.cli.Main &lt;arguments&gt;</code>. The arguments
+        consist of the options and infile and outfile specifications
+        as shown above for the standard scripts. You may wish to review
+        the standard scripts to make sure that 
+        you get your environment properly configured. 
+        </p>
+      </section>
+      <section id="jar-option">
+        <title>Running with java's <code>-jar</code> option</title>
+      <p>
+        As an alternative to the start scripts you can run <code>java
+        -jar path/to/build/fop.jar &lt;arguments&gt;</code>, relying on
+        FOP to build the classpath for running FOP dynamically, see <link href="#dynamical-classpath">below</link>. If you use hyphenation,
+        you must put <code>fop-hyph.jar</code> in the <code>lib</code>
+        directory.
+      </p>
+
+      <p>You can also run <code>java -jar path/to/fop.jar
+      &lt;arguments&gt;</code>, relying on the <code>Class-Path</code>
+      entry in the manifest file. This works if you put
+      <code>fop.jar</code> and all jar files from the <code>lib</code>
+      directory in a single directory. If you use hyphenation, you
+      must also put <code>fop-hyph.jar</code> in that directory.</p>
+
+    <p>In both cases the arguments consist of the options and
+        infile and outfile specifications as shown above for the
+        standard scripts.</p>
+      </section>
+      <section id="dynamical-classpath">
+        <title>FOP's dynamical classpath construction</title>
+
+        <p>If FOP is started without a proper classpath, it tries to
+          add its dependencies dynamically. If the system property
+          <code>fop.home</code> contains the name of a directory, then
+          FOP uses that directory as the base directory for its
+          search. Otherwise the current working directory is the base
+          directory. If the base directory is called <code>build</code>,
+          then its parent directory becomes the base directory.</p>
+
+        <p>FOP expects to find <code>fop.jar</code> in the
+          <code>build</code> subdirectory of the base directory, and
+          adds it to the classpath. Subsequently FOP adds all
+          <code>jar</code> files in the lib directory to the
+          classpath. The lib directory is either the <code>lib</code>
+          subdirectory of the base directory, or, if that does not
+          exist, the base directory itself.</p>
+
+        <p>If the system property <code>fop.optional.lib</code>
+          contains the name of a directory, then all <code>jar</code>
+          files in that directory are also added to the classpath. See
+          the methods <code>getJARList</code> and
+          <code>checkDependencies</code> in
+          <code>org.apache.fop.cli.Main</code>.</p>
+
+      </section>
+    </section>
+    <section id="check-input">
+      <title>Using Xalan to Check XSL-FO Input</title>
+      <p>
+        FOP sessions that use -xml and -xsl input instead of -fo input are actually 
+        controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting 
+        the XSL-FO to PDF (or another FOP output format).
+        Although FOP controls both of these processes, the first is included merely as 
+        a convenience and for performance reasons.
+        Only the second is part of FOP's core processing.
+        If a user has a problem running FOP, it is important to determine which of these 
+        two processes is causing the problem.
+        If the problem is in the first process, the user's stylesheet is likely the cause.
+        The FOP development team does not have resources to help with stylesheet issues, 
+        although we have included links to some useful 
+        <link href="../resources.html#specs">Specifications</link> and 
+        <link href="../resources.html#articles">Books/Articles</link>.
+        If the problem is in the second process, FOP may have a bug or an unimplemented 
+        feature that does require attention from the FOP development team.
+      </p>
+      <note>The user is always responsible to provide correct XSL-FO code to FOP.</note>
+      <p>
+        In the case of using -xml and -xsl input, although the user is responsible for 
+        the XSL-FO code that is FOP's input, it is not visible to the user. To make the 
+        intermediate FO file visible, the FOP distribution includes the "-foout" option 
+        which causes FOP to run only the first (transformation) step, and write the 
+        results to a file. (See also the Xalan command-line below)
+      </p>
+      <note>
+        When asking for help on the FOP mailing lists, <em>never</em> attach XML and 
+        XSL to illustrate the issue. Always run the XSLT step (-foout) and send the 
+        resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is 
+        correct before sending it.
+      </note>
+      <p>
+        The -foout option works the same way as if you would call the 
+        <link href="http://xml.apache.org/xalan-j/commandline.html">Xalan command-line</link>:
+      </p>
+      <p>
+        <code>java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile</code>
+      </p>
+      <p>
+        Note that there are some subtle differences between the FOP and Xalan command-lines.
+      </p>
+    </section>
+    <section id="memory">
+      <title>Memory Usage</title>
+      <p>
+        FOP can consume quite a bit of memory, even though this has been continually improved.
+        This is partly inherent to the formatting process and partly caused by implementation choices.
+        All FO processors currently on the market have memory problems with certain layouts.
+      </p>
+      <p>
+        If you are running out of memory when using FOP, here are some ideas that may help:
+      </p>
+      <ul>
+        <li>
+          Increase memory available to the JVM. See 
+          <link href="http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/java.html">the -Xmx option</link> 
+          for more information.
+          <warning>
+            It is usually unwise to increase the memory allocated to the JVM beyond the amount of 
+            physical RAM, as this will generally cause significantly slower performance.
+          </warning>
+        </li>
+        <li>
+          Avoid forward references.
+          Forward references are references to some later part of a document.
+          Examples include page number citations which refer to pages which follow the citation, 
+          tables of contents at the beginning of a document, and page numbering schemes that 
+          include the total number of pages in the document 
+          (<link href="../faq.html#pagenum">"page N of TOTAL"</link>).
+          Forward references cause all subsequent pages to be held in memory until the reference 
+          can be resolved, i.e. until the page with the referenced element is encountered.
+          Forward references may be required by the task, but if you are getting a memory 
+          overflow, at least consider the possibility of eliminating them.
+          A table of contents could be replaced by PDF bookmarks instead or moved to the end of 
+          the document (reshuffle the paper could after printing).
+        </li>
+        <li>
+          Avoid large images, especially if they are scaled down.
+          If they need to be scaled, scale them in another application upstream from FOP.
+          For many image formats, memory consumption is driven mainly by the size of the image 
+          file itself, not its dimensions (width*height), so increasing the compression rate 
+          may help.
+        </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 additional memory is 
+          freed after the page sequence has been rendered.
+          This can be substantial if the page sequence contains lots of FO elements.
+        </li>
+      </ul>
+    </section>
+    <section id="problems">
+      <title>Problems</title>
+      <p>If you have problems running FOP, please see the <link href="../gethelp.html">"How to get Help" page</link>.</p>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: xmlgraphics/site/deploy/fop/trunk/running.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/site/deploy/fop/trunk/running.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: xmlgraphics/site/deploy/fop/trunk/servlets.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/servlets.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/servlets.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/servlets.html Thu Aug 23 12:00:37 2007
@@ -58,10 +58,10 @@
 <a class="base-not-selected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.20.5/index.html">Version 0.20.5</a>
+<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
-<a class="base-not-selected" href="../0.93/index.html">Version 0.93</a>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
 </li>
 <li class="current">
 <a class="base-selected" href="../trunk/index.html">FOP Trunk</a>
@@ -178,10 +178,20 @@
     |start content
     +-->
 <div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="servlets.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
+        XML</a>
+</div>
 <div title="Portable Document Format" class="pdflink">
 <a class="dida" href="servlets.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
 </div>
+<div class="trail">
+<text>Font size:</text> 
+	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
+	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
 <h1>Servlets</h1>
 <h3>How to use Apache FOP in a Servlet</h3>
 <div id="minitoc-area">
@@ -387,7 +397,7 @@
           
 <li>
             Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream
-            implementation from the <a href="http://jakarta.apache.org/commons/io/">Jakarta Commons IO project</a> which allocates less memory.
+            implementation from the <a class="external" href="http://jakarta.apache.org/commons/io/">Jakarta Commons IO project</a> which allocates less memory.
             The full class name is: <span class="codefrag">org.apache.commons.io.output.ByteArrayOutputStream</span>
           
 </li>
@@ -558,7 +568,7 @@
 <p>
         Sometimes the requirements for a servlet get quite sophisticated: SQL data sources, 
         multiple XSL transformations, merging of several datasources etc. In such a case 
-        consider using <a target="_blank" class="fork" href="http://cocoon.apache.org/">Apache Cocoon</a> instead 
+        consider using <a class="external" href="http://cocoon.apache.org/">Apache Cocoon</a> instead 
         of a custom servlet to accomplish your goal.
       </p>
 </div>

Modified: xmlgraphics/site/deploy/fop/trunk/servlets.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/servlets.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/servlets.pdf (original)
+++ xmlgraphics/site/deploy/fop/trunk/servlets.pdf Thu Aug 23 12:00:37 2007
@@ -634,8 +634,8 @@
 86 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
 87 0 obj
@@ -648,15 +648,15 @@
 88 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F6
-/BaseFont /Times-Italic
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
 89 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F2
+/BaseFont /Helvetica-Oblique
 /Encoding /WinAnsiEncoding >>
 endobj
 90 0 obj
@@ -669,8 +669,8 @@
 91 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F2
-/BaseFont /Helvetica-Oblique
+/Name /F6
+/BaseFont /Times-Italic
 /Encoding /WinAnsiEncoding >>
 endobj
 92 0 obj
@@ -694,7 +694,7 @@
 endobj
 3 0 obj
 << 
-/Font << /F3 86 0 R /F5 87 0 R /F1 89 0 R /F6 88 0 R /F9 90 0 R /F2 91 0 R /F7 92 0 R >> 
+/Font << /F1 86 0 R /F5 87 0 R /F3 88 0 R /F2 89 0 R /F9 90 0 R /F6 91 0 R /F7 92 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -869,11 +869,11 @@
 0000023742 00000 n 
 0000023918 00000 n 
 0000024163 00000 n 
-0000024276 00000 n 
-0000024386 00000 n 
-0000024497 00000 n 
-0000024605 00000 n 
-0000024711 00000 n 
+0000024271 00000 n 
+0000024381 00000 n 
+0000024494 00000 n 
+0000024610 00000 n 
+0000024716 00000 n 
 0000024827 00000 n 
 trailer
 <<



---------------------------------------------------------------------
Apache XML Graphics Project URL: http://xmlgraphics.apache.org/
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org