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>
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <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&ICS1=37&ICS2=100&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>
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <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 <CLASSPATH>
+ org.apache.fop.cli.Main <arguments></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 <arguments></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
+ <arguments></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>
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <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