xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From vhenneb...@apache.org
Subject svn commit: r569118 [5/49] - in /xmlgraphics/site/deploy/fop: ./ 0.93/ 0.94/ 0.94/images/ dev/ dev/design/ skin/ trunk/
Date Thu, 23 Aug 2007 19:00:51 GMT
Added: xmlgraphics/site/deploy/fop/0.93/pdfencryption.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/pdfencryption.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/pdfencryption.xml (added)
+++ xmlgraphics/site/deploy/fop/0.93/pdfencryption.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,227 @@
+<?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: 493717 $</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>
+      <warning>
+        PDF Encryption is available in Release 0.20.5 and later. The comments on this page do 
+        not apply to releases earlier than 0.20.5.
+      </warning>
+      <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/0.93/pdfencryption.xml
------------------------------------------------------------------------------
    svn:eol-style = native

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

Modified: xmlgraphics/site/deploy/fop/0.93/pdfx.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/pdfx.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/pdfx.html (original)
+++ xmlgraphics/site/deploy/fop/0.93/pdfx.html Thu Aug 23 12:00:37 2007
@@ -57,13 +57,13 @@
 <li>
 <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>
-</li>
 <li class="current">
 <a class="base-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
+</li>
+<li>
 <a class="base-not-selected" href="../trunk/index.html">FOP Trunk</a>
 </li>
 <li>
@@ -187,10 +187,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">
@@ -229,9 +239,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/0.93/pdfx.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/pdfx.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/pdfx.pdf (original)
+++ xmlgraphics/site/deploy/fop/0.93/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/0.93/pdfx.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/pdfx.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/pdfx.xml (added)
+++ xmlgraphics/site/deploy/fop/0.93/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/0.93/pdfx.xml
------------------------------------------------------------------------------
    svn:eol-style = native

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

Modified: xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.html (original)
+++ xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.html Thu Aug 23 12:00:37 2007
@@ -5,7 +5,7 @@
 <meta content="Apache Forrest" name="Generator">
 <meta name="Forrest-version" content="0.7">
 <meta name="Forrest-skin-name" content="pelt">
-<title>Release Notes for Apache Forrest 0.93</title>
+<title>Release Notes for Apache FOP 0.93</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
 <link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
 <link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
@@ -57,13 +57,13 @@
 <li>
 <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>
-</li>
 <li class="current">
 <a class="base-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
+</li>
+<li>
 <a class="base-not-selected" href="../trunk/index.html">FOP Trunk</a>
 </li>
 <li>
@@ -187,11 +187,21 @@
     |start content
     +-->
 <div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="releaseNotes_0.93.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="releaseNotes_0.93.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
         PDF</a>
 </div>
-<h1>Release Notes for Apache Forrest 0.93</h1>
+<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>Release Notes for Apache FOP 0.93</h1>
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -265,7 +275,7 @@
 <img class="icon" alt="add" src="../images/add.jpg">
         Support for the rgb-icc() function and for a proprietary cmyk() function (for device CMYK
         colors only through the PDF renderer so far). 
-      (JM) Thanks to Peter Coppens. Fixes <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=40729">40729</a>.</li>
+      (JM) Thanks to Peter Coppens. Fixes <a class="external" href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=40729">40729</a>.</li>
 <li>
 <img class="icon" alt="add" src="../images/add.jpg">
         Added support for PDF/A-1b and PDF/X-3:2003. (Note: this may still be a bit
@@ -279,7 +289,7 @@
 <li>
 <img class="icon" alt="update" src="../images/update.jpg">
         Enabled Copy/Paste from PDF content in Acrobat Reader for text using embedded TrueType fonts.
-      (BD) Thanks to Adam Strzelecki, Victor Mote. Fixes <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=5535">5535</a>.</li>
+      (BD) Thanks to Adam Strzelecki, Victor Mote. Fixes <a class="external" href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=5535">5535</a>.</li>
 <li>
 <img class="icon" alt="update" src="../images/update.jpg">
         The Java2DRenderer (and therefore the print and bitmap renderers) is now

Modified: xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.pdf (original)
+++ xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.pdf Thu Aug 23 12:00:37 2007
@@ -5,10 +5,10 @@
 /Producer (FOP 0.20.5) >>
 endobj
 5 0 obj
-<< /Length 462 /Filter [ /ASCII85Decode /FlateDecode ]
+<< /Length 457 /Filter [ /ASCII85Decode /FlateDecode ]
  >>
 stream
-Gau0?4*-$.%,Udp)O$l3&'UeQP;[XP?(]/[l#gs$Jb0RKNJI5b(IK)`6aiAuP5O,`ksJXMT"j:#![Nli*cY9D&L]aKV#;]0XGqo75p"%-mbq[LVKPQiC(=;rMVH2)PI@J/gg$>b\Z'.@Nj($NN,%\j+IMXYHp[\V<Y>Er<&.#u,(Yu6IJQpGG9*Are]r8#fU8nDWbcb;'0s[(06[7[:^j(iNfLql$;T4[pecM5c1UmuV6#QgoffU^#5_\oAueFQ^=1BGbFUU>9a#K\@)gL5OZ6]eNpL*_4=:C\!lY:l^TY&MZEe+B=mF8qLFp*j\[W&#+\>Ed\4aO(DS3TlU*RTH5S1Lu,fg**"hFBm/_jO6UKRe1('S0S'oXpR:H45a&21Mn@AkuWUfEm-Yl6el'$i4dlAk4i@MfK/)04<WQe'a>^AkOs'h6d92JZ-44K)!5kIUAB%fZP("OtW~>
+Gau0?4]?tu&FK9.>EZkb4ua&=9JeOdUIL$DE@`a'J2djj5b\3a%Usr&Z-#r!mbXGB]8tcnm!)/5bXV_Sl4A:g%Y;it5h_9NA8Nme$1]3lGRs92X57PjlPWq^)7GUoPA,,%\>cG3kGD3M5/JqE=+`joi\U@[pn=fV!^0L;8M-`'b(Dm#XOb"D9\;sCP7DbFMFJCVIH2&,acnHcr'F6PAPYh:?oA0Ylid6b55W@rI#D5E=l4BEfG9,<VQ5#Y7Y/;&cG[nt2CFIeEdPT5BB4lM0/uJq-O64VKG&iFK"p30VJ9)XS5Ej+2PV?Pn)icl1>%7*3n<.@G.tQ8mcKB>M,JjGfL[@0"B6:;kJ`kDQ!d+i#_l%L@^H`+1CK7'MLuJ@gZ:-=8YoF^2a_!Oo?TI>eK*<\`?5j+1?>O7c^UfEp:Tkm/uqs>Dj))>a+L83][W2&d,?Y&eC)P~>
 endstream
 endobj
 6 0 obj
@@ -71,10 +71,10 @@
 >>
 endobj
 14 0 obj
-<< /Length 2261 /Filter [ /ASCII85Decode /FlateDecode ]
+<< /Length 2256 /Filter [ /ASCII85Decode /FlateDecode ]
  >>
 stream
-Gatm=8U&oI&AII3YW:D*eIW$">^WlK.*lUuW4&-AYO2Fc+GhtbJ<ZE"q@5H(+Hi&OQfK9?iW-<4o?@\k3?*r*9J\*E[FoSrCTESkl1!TWSDos].'[nfRml&g-aRrWSSDf%l0uk&rgp;^]3#7mbM-SXPJtPfK-Y?,XX%6r#q83W1\;em%dY3oVfjfj12RhVZ4M*0KUcfWBX:KBQE`;?29E4]kLM!9;p)NMX<ZZfV#V`@j+HY;*uX6(Lkko$k^"ts*qW8?kG=6X!^D%N4Z`+H]:+YJPBJt(3i#Zh[R%PEct(BW]TJ"cB;c<5PgIDN;FJX%=R:7<mLj]-RrseUbpdj'%!^;uU,3:'lshRA$KEe%m=HQIK&6&Q^ekuf=l1[nb8C5L!'LM]H=5oSGJCTpKBR^nB-&:8isHh\Y^h:c"Z7M:06iUbg"qfEQP/>GO;%`ug#"NPY;jO<2`Dp%^EBUp&1!UYZcI+0OMsg-/HsHZ;Ig($$<$"19V)HMY^eP:_?7G]]>sFDZb;YHL4T45-VqfL6'cAld6A_jHOeiMBMW`l%QH!==E_jl=8WXsP+D&a.Qrq((e&914kX3_+W-(!<6.<QH+F9I9-H`o@pH,2@utLP#&'6AM((AZg@*t]9W;,TfM!.!h/io%!;L@Dju]j3a__.Ap:EQ<U(dYn^H2]-*=P#u@J..bE_U#1G'/Ul[(bN!ir-%24C2Gmi"Z1Eompc,-\%MCIZ/C.)MVa;n7bhAdYb?k=b`fqPrAR#m72"m.Hst(S#ohTE4U4)!#]NLB_0UnUWZe_Jl24d+7&Z<'>I<pLG7K<'`fsQ2Sq]R[*-cfSaPN)OYS0t1ca[;-7or]<'P?V*r4NKjaLXi.tfJc@Wj1)/uVN/5aYE[8%M*DhOnAT_U,S*1%ZA-T9ENMX-&*4)339qDI_CGgcD^kUi@Tsp-9^#DP4cpN?PBd4kpE`'<^u1Ac%'\Y`h^@SZufCEq$g'd=%R*S01G^3t6q
 c;5/gHmKkVKqc/s]g:PaQ'8B"nd\#fOg)9f5Ifou8o2$h\AG2+Hkuks/h1gS:%:)J<,'/bn\jJnf#p'[298.g5pR#hq`6<s/(h'UGO6PrJBjWf8Mc`MXYj@bfW8K^lQT`ePLoJu-(Q/I":Y@'H]J`S)Pg[;a)Q(6E!el'rOt)_DcB8.q:G1P^TC+5r-?FukP_I<bii*+L%Q?t^k%B86hk(TD[G[*i-;11Z<4aPi,YatJaLO^@KHIlim+_Jf[i@U:\F[5Aq>OT*br73k3?+Id,YTKSEtX6]fOgOf<^XdBo_eojBtSs[#O.GG%VEiEr@,R_J%EJ9bokmbnE>a?Va*qc91Vs2%;ra)<PsjG;.m%)+k(+qH)>(U:6fgbB+X?[(JI@D7uO%N;]^T\U,#5cddF,_)VhGcm`)Tf?'0%Wh4\/W(M<%$J`tq'K7IYO6H;>1"IqCs0>r!\EG!E"E*W>=mE@\j\o&u@XUB>;N@U!/Q3XopbXHGZbQHs1U+'!PF$O<=!A/_0m6lcLSGNiq2<.8]Ya+tej0-;ZSf$\BOT_[?7%g#3M-r=:%ug\352+u5D;jg,)'r'C_9;I65'<I1A@[L+3O]Vb>DUKVB)A;nG.g[7g<sZP":BM%XsXn41/'o^6n=qF3(N:m^Lk/qnTo;UitC[FkS+*Q"T/fIhF'%&Sp;2LH%rr*V+`'Z&X8,&=/J+8d9QH%R</#\Xl'R\C20RWcfinRVHfLFBJ.eFT#ltjC1g=MCt=b7#pI9i<D>W0KJ+)\=al^\s.Ct8*s*.aYCW<U1N&@2=5V$G-H*oYR?9gW_b-B+FK.HK)c*s?,0)BLZ6#TT:IO[>-#*eYQ[TVW6"!>kZYndZFt2gk9$!+\;?2<'mX!%J)Ba+ZfSHH]17ho^W$?t9gTqSlJZ!O-`hRu^RU/XF5;kV4E`=%RckX!PDe_kTl`gFuDl5A8$AY>)`E-6HPU93_%stI&I%aeLk>)/g[ADG;5(H4C9:;
 e77C^@QOQ1pLn]j=">%tr9+jZE3$/WV^U8t\"Fmpjn\I<j2S0]-=Md\fH0U>lZf#=_%>-@#',\BlVZLPAoiuEi!N_QRaABL+)#e0,XPl#5rBTbn8Wki`QXE,6^Bj>6p\<o7W*gM6nQnhJW]:(P&fQ9gs$uhb@nS*CR[QTQnbF:!ki$+QU(h+!_,<6b,_UqG>HD_+cNa&5Q$D(<]?9O[j[,7#!jgtBMOocg79r.0^Job1phLD*Zl1oT%*/,obdkq8jn8]b:aOPO'UuU#rrr^nJ6Qu~>
+Gatm=8U&oI&AJ$CYW:D*eIW$">^WlK36u<0W4&-AYO2E8+c/(cJ<ZE"q@5H(+Hi&OQfK9?iW-<4o?@\k0fth/1!Q@Zf4Kpc?!A?fRL]?,bpf:<N"T@(ZrsL/I6:_fq2'8eR1?tOj6srZFGiR9o:fH$1(Df`&Z/.oCajX[,c$5!cd@Ae0sZ!IT";nkQYEqudm2,c'69iGUWkuR=iSH4eKiTfT%fWS:FY$(Yb$BC<s"=_XUhQBHt6.E0H'J7U?hXIHIP;j;H,gm!Ija"HZ\8pDD`46-f&ftFi^A/D8TmEU</;UGU&>-c;5NH.A<jGUkmJi&aX\ImLj])RrseUm4!6GN-NlKj"(O_iaXM7'&tX1h1?k9K&6&Q`).Dkg!D25b8C5l!'Q%TC1QLGGJA>0KBPZ4B-&:8lO'3d=MV_mJsrr8!a]J?^,%%YV8P>=,c/:Ip@h8C99(a]c]+;>0*l?/"Na+-/92^dA?h:d$c.b/'KLcWJs<g%d\d[&"HXs=["juapFq&([b(&e3,ft&oEdN+bk!\MqWD@5a+;t^*Jc?$!b^mBbO4$@P!;9(o!=l^V$F:,UPKAnVe_59"=*H,#oO'r:P3Vk&5jbW`l3g"L?VlNJArInQu\+lq[QrXQ&;Djc%I7q9t0U&JBuhEYn`1JgbquH^\]f;9-Nfr]=j<Q_m#mRept@af-H)bf7t26lPogVhX>L(P9gD::>rC)+*_C=nqYoGO!C4*L>gc'I+m)T['D6.QD&#5WK$q&qb]GTQ#nSPc.4F:3*eU'J.+:a[/&)k7i/N."Jb6P4uVla-@VRj%UlfV/HT7/CkR<-Bigq73rR*q,#q/bBQC,49j/uDWkRZ)"7hEhMqu7Q<si.S`9^))>Yq'*LG5KFLNJ4[]g]t>KqW'4@d"7f5,X)o;^2[D1*!Fpgr-So\8u,S8aAd#m@HMCh*?Nk>!lCD]>#0=-=#lma:8BWA1*`93b-JejktR-UUrSI,Xms5[i,Z
 PTL=i-g_4-tpZjC/F`=+p3f4F"A2r+`ZnqJIrWiqNkE/S3a;c<Ge$Fj=].F=t)S1s8<#-HPFH;;3;`l7/<!rR\mP3P'Lm]i]0Z%.m*n/Yre%KYO(9rt:B\>0^:r.;J070R+&6!KMc@Z,KVgP&#?5k=&9'K]D%9$UhJ\jTtacoD]'Zg=K`u"45:NdIrP<$QFa?o"jnMC;kqjSjto@)(\muL,43q+M$PGQ\hWa1iEP%N&u'O7A5_N/%FG3san?&g!ogj*/]I/e&^k*m-FS?:%b)Pn)B3DH4aCpQgebH^#7qYgi"BbE\'KCm8_#IE@Zre+\05M]`-ArppAG]ZB[;]mFB-);Eo"uk@>Fi06g;.m%)+k(+gH)>(U:7ZBjB+X?[(JI@D7uO(O;]\><U,#5cddHCJ)VqMhmae_6?'0%Wh4\/M(M<$YJ`tp\K7I[%6AIfF"IqCs0>r!RIVR(sE*WD?mF47n\o&u@D$p"kN@U!/?A,g`bf*t!bX:JqU+K9tF$OTE!A/_8m?J7!SGNi72<.7rYa+tej0-G^NYq!2JHVu/7%iiiNF=g?pPf9q52,#6:#R&:)'r'C_9;I65'<I3jFrEa3O]bf%7KWNZ[Gt%qqe4lm:`k<!en=#f2l%PAXIrGLfQcj8V,IUJ'A2Niq;M3a!K:[d4#5W$2>Ym]np,,4S(=rnf2jB$^o",+t+++ThKaAUH/'[3p5_I>JUD8C20RWcfio%Y$@?NGV7KVT#nC=CZdrjCt=_6"X1jeF\U\IK[0a\/AE^rJ'aMW%j?haf?c1T))l8pX)DK^'4PIhbXeG<@22L@3`VcaNMjC:O^f4af`4fl-_bg/&iGC=90W]:+L%QB=[-nEH^481-"KPi.0)YDG<JrPNK?/>Cs957):(#ke.G$Xm9'^o^f*6QkOC5U9s:>2+);pO"Y("0lj?t=2mjpe%9S.b[oJi.V8H-pi[_-48e\.+6j$LP^/1u7M^O)1g.LZ3+2F\]ThO
 "(10bK#a@SslG\<X!XgI)XL_i[Q"E3:?dFVR$3d;Bt6A@Z:cI92n`Aer<(eZFhCC;$_(pt>#`!kq]-JioUSDt1,Z"Y5E>^=cei+@D/EIXel21K8lXF'\,OMOp@Jp3'hROJP6JLRq4Z)ohbD,&X3?qtg77d4W.q6`5A,,<oI%%na\lPLfU$I^sSkJG//NFo(,]8g(r:'t=W'OF"k^NA@qajmu.=2>E$rm>ml8N3g$m(Y$-lteG&Nh`H3fa?_/GdS,Tj`7XtZUs>TrrFjO5j/~>
 endstream
 endobj
 15 0 obj
@@ -156,8 +156,8 @@
 24 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
 25 0 obj
@@ -170,8 +170,8 @@
 26 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
 27 0 obj
@@ -202,7 +202,7 @@
 endobj
 3 0 obj
 << 
-/Font << /F3 24 0 R /F5 25 0 R /F1 26 0 R /F2 27 0 R /F7 28 0 R >> 
+/Font << /F1 24 0 R /F5 25 0 R /F3 26 0 R /F2 27 0 R /F7 28 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -225,34 +225,34 @@
 xref
 0 29
 0000000000 65535 f 
-0000005828 00000 n 
-0000005893 00000 n 
-0000005985 00000 n 
+0000005818 00000 n 
+0000005883 00000 n 
+0000005975 00000 n 
 0000000015 00000 n 
 0000000071 00000 n 
-0000000624 00000 n 
-0000000744 00000 n 
-0000000790 00000 n 
-0000006108 00000 n 
-0000000924 00000 n 
-0000006171 00000 n 
-0000001060 00000 n 
-0000001242 00000 n 
-0000001428 00000 n 
-0000003782 00000 n 
-0000003905 00000 n 
-0000003953 00000 n 
-0000004163 00000 n 
-0000004374 00000 n 
-0000004556 00000 n 
-0000006237 00000 n 
-0000004742 00000 n 
-0000005025 00000 n 
-0000005272 00000 n 
-0000005385 00000 n 
-0000005495 00000 n 
-0000005603 00000 n 
-0000005719 00000 n 
+0000000619 00000 n 
+0000000739 00000 n 
+0000000785 00000 n 
+0000006098 00000 n 
+0000000919 00000 n 
+0000006161 00000 n 
+0000001055 00000 n 
+0000001237 00000 n 
+0000001423 00000 n 
+0000003772 00000 n 
+0000003895 00000 n 
+0000003943 00000 n 
+0000004153 00000 n 
+0000004364 00000 n 
+0000004546 00000 n 
+0000006227 00000 n 
+0000004732 00000 n 
+0000005015 00000 n 
+0000005262 00000 n 
+0000005370 00000 n 
+0000005480 00000 n 
+0000005593 00000 n 
+0000005709 00000 n 
 trailer
 <<
 /Size 29
@@ -260,5 +260,5 @@
 /Info 4 0 R
 >>
 startxref
-6288
+6278
 %%EOF

Added: xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml (added)
+++ xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document><header><title>Release Notes for Apache FOP 0.93</title></header><body><notes>
+        <p>This is the first production grade release of the new FOP
+        codebase.</p>
+        <ul>
+          <li>It contains the new API first introduced in release 0.92
+            beta. The preceding API has been removed.
+          </li>
+          <li>
+            See the <a href="../compliance.html">compliance page</a> for an
+            overview of the compliance of this release with the XSL 1.0 and
+            1.1 recommendations.
+          </li>
+          <li>
+            This release again contains many bug fixes and new features. See
+            below for details.
+          </li>
+          <li>
+            See the <a href="../knownissues.html">known issues page</a>
+            for an overview of the known issues with this release.
+          </li>
+        </ul>
+        <p>Caveats:</p>
+        <ul>
+          <li>
+            You may experience different behaviour compared to version 0.20.5.
+            Please consult the <a href="upgrading.html">"Upgrading"</a> page for details.
+          </li>
+        </ul>
+      </notes><section id="version_0.93"><title>Major Changes in Version 0.93</title><note>This is not a complete list of changes, a 
+   full list of changes in this release
+   <a href="changes_0.93.html">is available</a>.</note><section><title>Important Changes Code Base</title><ul><li><icon alt="add" src="../images/add.jpg"/>
+        Added support for the use of Open Type fonts
+      (BD)</li><li><icon alt="add" src="../images/add.jpg"/>
+        Support for the rgb-icc() function and for a proprietary cmyk() function (for device CMYK
+        colors only through the PDF renderer so far). 
+      (JM) Thanks to Peter Coppens. Fixes <link href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=40729">40729</link>.</li><li><icon alt="add" src="../images/add.jpg"/>
+        Added support for PDF/A-1b and PDF/X-3:2003. (Note: this may still be a bit
+        incomplete. Feedback is welcome!)
+      (JM)</li><li><icon alt="add" src="../images/add.jpg"/>
+       Automatic support for all fonts available to the Java2D subsystem for all
+       Java2D-descendant renderers (TIFF, PNG, print, AWT).
+     (JM)</li><li><icon alt="update" src="../images/update.jpg"/>
+        Enabled Copy/Paste from PDF content in Acrobat Reader for text using embedded TrueType fonts.
+      (BD) Thanks to Adam Strzelecki, Victor Mote. Fixes <link href="http://issues.apache.org/bugzilla/buglist.cgi?bug_id=5535">5535</link>.</li><li><icon alt="update" src="../images/update.jpg"/>
+        The Java2DRenderer (and therefore the print and bitmap renderers) is now
+        offering the same quality as the PDF and PS renderers. Note: There can still
+        be little differences between PDF and Print/PNG/TIFF because the latter uses
+        a different font metrics source.
+      (JM)</li></ul></section></section></body></document>
\ No newline at end of file

Propchange: xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/site/deploy/fop/0.93/releaseNotes_0.93.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: xmlgraphics/site/deploy/fop/0.93/running.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/running.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/running.html (original)
+++ xmlgraphics/site/deploy/fop/0.93/running.html Thu Aug 23 12:00:37 2007
@@ -57,13 +57,13 @@
 <li>
 <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>
-</li>
 <li class="current">
 <a class="base-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
+</li>
+<li>
 <a class="base-not-selected" href="../trunk/index.html">FOP Trunk</a>
 </li>
 <li>
@@ -187,10 +187,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">
@@ -252,24 +262,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>
         
@@ -336,7 +346,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">
@@ -449,23 +459,23 @@
 <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. FOP uses the current working
-		directory as the base directory for its search. If the base
-		directory is called <span class="codefrag">build</span>, then its parent
-		directory becomes the base directory.</p>
+        add its dependencies dynamically. FOP uses the current working
+        directory as the base directory for its search. 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="N10132"></a><a name="check-input"></a>
@@ -510,7 +520,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>
         
@@ -537,7 +547,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>

Modified: xmlgraphics/site/deploy/fop/0.93/running.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/running.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/running.pdf (original)
+++ xmlgraphics/site/deploy/fop/0.93/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%N]X&$9LK;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#'\2SY5~>
+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%cN,[j`Z+&BClepJ'7$flnP]g31%*go+)-p1as2`*#6#AF&hu1"=!8O^;/eGbf?F7VB[ei),<_p"^c1_'k_^+X8$+o<,pJAg-!5*qe9$Jb^;C=cp;[b@_[PhKB+0M,-R8*;lTCi^(0BlTSI,3>_9p1*Uha+iX.5[iXL=DNXYh9mIMqh$/?;D"?-i.Aj,n&9lIRNr+/mlB$4MQH-<>7XPrkBe2m=,-63@2Wc]/+X^n7h(Mru]EP:a-emN<LqHNcd9T'mXdofhN8T_bFd7]npl6Kej[D9K4bLhUlJFPSkN[/?C3#>"t-ZrB7V#h-4g$u1Dd0b7S0iibUg+m4ag9T[I,bdSCH>H9eJG?<JZ<K8W@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
@@ -806,8 +806,8 @@
 99 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
 100 0 obj
@@ -820,15 +820,15 @@
 101 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F6
-/BaseFont /Times-Italic
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
 102 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F2
+/BaseFont /Helvetica-Oblique
 /Encoding /WinAnsiEncoding >>
 endobj
 103 0 obj
@@ -841,8 +841,8 @@
 104 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F2
-/BaseFont /Helvetica-Oblique
+/Name /F6
+/BaseFont /Times-Italic
 /Encoding /WinAnsiEncoding >>
 endobj
 105 0 obj
@@ -866,7 +866,7 @@
 endobj
 3 0 obj
 << 
-/Font << /F3 99 0 R /F5 100 0 R /F1 102 0 R /F6 101 0 R /F9 103 0 R /F2 104 0 R /F7 105 0 R >> 
+/Font << /F1 99 0 R /F5 100 0 R /F3 101 0 R /F2 102 0 R /F9 103 0 R /F6 104 0 R /F7 105 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -1048,11 +1048,11 @@
 0000029237 00000 n 
 0000029414 00000 n 
 0000029554 00000 n 
-0000029667 00000 n 
-0000029778 00000 n 
-0000029890 00000 n 
-0000029999 00000 n 
-0000030106 00000 n 
+0000029662 00000 n 
+0000029773 00000 n 
+0000029887 00000 n 
+0000030004 00000 n 
+0000030111 00000 n 
 0000030223 00000 n 
 trailer
 <<

Added: xmlgraphics/site/deploy/fop/0.93/running.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/running.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/running.xml (added)
+++ xmlgraphics/site/deploy/fop/0.93/running.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,345 @@
+<?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. Support for some graphics formats requires additional packages. 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 availabe 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. FOP uses the current working
+        directory as the base directory for its search. 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>
+      <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 
+        <link href="../dev/index.html">FOP Redesign</link>.
+      </p>
+    </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/0.93/running.xml
------------------------------------------------------------------------------
    svn:eol-style = native

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

Modified: xmlgraphics/site/deploy/fop/0.93/servlets.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/servlets.html?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/servlets.html (original)
+++ xmlgraphics/site/deploy/fop/0.93/servlets.html Thu Aug 23 12:00:37 2007
@@ -57,13 +57,13 @@
 <li>
 <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>
-</li>
 <li class="current">
 <a class="base-selected" href="../0.93/index.html">Version 0.93</a>
 </li>
 <li>
+<a class="base-not-selected" href="../0.94/index.html">Version 0.94</a>
+</li>
+<li>
 <a class="base-not-selected" href="../trunk/index.html">FOP Trunk</a>
 </li>
 <li>
@@ -187,10 +187,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">
@@ -393,7 +403,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>
@@ -496,7 +506,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/0.93/servlets.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/servlets.pdf?rev=569118&r1=569117&r2=569118&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/servlets.pdf (original)
+++ xmlgraphics/site/deploy/fop/0.93/servlets.pdf Thu Aug 23 12:00:37 2007
@@ -571,8 +571,8 @@
 78 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F3
-/BaseFont /Helvetica-Bold
+/Name /F1
+/BaseFont /Helvetica
 /Encoding /WinAnsiEncoding >>
 endobj
 79 0 obj
@@ -585,15 +585,15 @@
 80 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F6
-/BaseFont /Times-Italic
+/Name /F3
+/BaseFont /Helvetica-Bold
 /Encoding /WinAnsiEncoding >>
 endobj
 81 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F1
-/BaseFont /Helvetica
+/Name /F2
+/BaseFont /Helvetica-Oblique
 /Encoding /WinAnsiEncoding >>
 endobj
 82 0 obj
@@ -606,8 +606,8 @@
 83 0 obj
 << /Type /Font
 /Subtype /Type1
-/Name /F2
-/BaseFont /Helvetica-Oblique
+/Name /F6
+/BaseFont /Times-Italic
 /Encoding /WinAnsiEncoding >>
 endobj
 84 0 obj
@@ -631,7 +631,7 @@
 endobj
 3 0 obj
 << 
-/Font << /F3 78 0 R /F5 79 0 R /F1 81 0 R /F6 80 0 R /F9 82 0 R /F2 83 0 R /F7 84 0 R >> 
+/Font << /F1 78 0 R /F5 79 0 R /F3 80 0 R /F2 81 0 R /F9 82 0 R /F6 83 0 R /F7 84 0 R >> 
 /ProcSet [ /PDF /ImageC /Text ] >> 
 endobj
 9 0 obj
@@ -792,11 +792,11 @@
 0000020434 00000 n 
 0000020610 00000 n 
 0000020855 00000 n 
-0000020968 00000 n 
-0000021078 00000 n 
-0000021189 00000 n 
-0000021297 00000 n 
-0000021403 00000 n 
+0000020963 00000 n 
+0000021073 00000 n 
+0000021186 00000 n 
+0000021302 00000 n 
+0000021408 00000 n 
 0000021519 00000 n 
 trailer
 <<

Added: xmlgraphics/site/deploy/fop/0.93/servlets.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/0.93/servlets.xml?rev=569118&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/0.93/servlets.xml (added)
+++ xmlgraphics/site/deploy/fop/0.93/servlets.xml Thu Aug 23 12:00:37 2007
@@ -0,0 +1,257 @@
+<?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>Servlets</title>
+    <subtitle>How to use Apache FOP in a Servlet</subtitle>
+    <version>$Revision: 493717 $</version>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <p>
+        This page discusses topic all around using Apache FOP in a servlet environment.
+      </p>
+    </section>
+    <section id="example-servlets">
+      <title>Example Servlets in the FOP distribution</title>
+      <p>
+        In the directory {fop-dir}/src/java/org/apache/fop/servlet, you'll find a working example
+        of a FOP-enabled servlet.
+      </p>
+      <p>
+        The servlet is automatically built when you build Apache FOP using the supplied Ant script. After building 
+        the servlet, drop fop.war into the webapps directory of Apache Tomcat (or any other web container). Then, you can use 
+        URLs like the following to generate PDF files:
+      </p>
+      <ul>
+        <li>http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo</li>
+        <li>http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&amp;xsl=/home/path/to/xslfile.xsl</li>
+      </ul>
+      <p/>
+      <p>The source code for the servlet can be found under {fop-dir}/src/java/org/apache/fop/servlet/FopServlet.java.</p>
+      <note>
+        This example servlet should not be used on a public web server connected to the Internet as it does not contain
+        any measures to prevent Denial-of-Service-Attacks. It is provided as an example and as a starting point for
+        your own servlet.
+      </note>
+    </section>
+    <section id="servlet">
+      <title>Create your own Servlet</title>
+      <note>
+        This section assumes you are familiar with <link href="embedding.html">embedding FOP</link>.
+      </note>
+      <section id="minimal-servlet">
+        <title>A minimal Servlet</title>
+        <p>
+          Here is a minimal code snippet to demonstrate the basics:
+        </p>
+        <source xml:space="preserve"><![CDATA[private FopFactory fopFactory = FopFactory.newInstance();
+private TransformerFactory tFactory = TransformerFactory.newInstance();
+        
+public void doGet(HttpServletRequest request,
+                   HttpServletResponse response) throws ServletException {
+    try {
+        response.setContentType("application/pdf");
+        Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, response.getOutputStream());
+        Transformer transformer = tFactory.newTransformer();
+        Source src = new StreamSource("foo.fo");
+        Result res = new SAXResult(fop.getDefaultHandler());
+        transformer.transform(src, res);
+    } catch (Exception ex) {
+        throw new ServletException(ex);
+    }
+}]]></source>
+        <note>
+          There are numerous problems with the code snippet above.
+          Its purpose is only to demonstrate the basic concepts.
+          See below for details.
+        </note>
+      </section>
+      <section id="xslt">
+        <title>Adding XSL tranformation (XSLT)</title>
+        <p>
+          A common requirement is to transform an XML source to
+          XSL-FO using an XSL transformation. It is recommended to use
+          JAXP for this task. The following snippet shows the basic
+          code:
+        </p>
+        <source xml:space="preserve"><![CDATA[private FopFactory fopFactory = FopFactory.newInstance();
+private TransformerFactory tFactory = TransformerFactory.newInstance();
+
+public void init() throws ServletException {
+    //Optionally customize the FopFactory and TransformerFactory here
+}
+
+[..]
+
+    //Setup a buffer to obtain the content length
+    ByteArrayOutputStream out = new ByteArrayOutputStream();
+
+    //Setup FOP
+    Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out);
+
+    //Setup Transformer
+    Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl"));
+    Transformer transformer = tFactory.newTransformer(xsltSrc);
+
+    //Make sure the XSL transformation's result is piped through to FOP
+    Result res = new SAXResult(fop.getDefaultHandler());
+
+    //Setup input
+    Source src = new StreamSource(new File("foo.xml"));
+
+    //Start the transformation and rendering process
+    transformer.transform(src, res);
+
+    //Prepare response
+    response.setContentType("application/pdf");
+    response.setContentLength(out.size());
+    
+    //Send content to Browser
+    response.getOutputStream().write(out.toByteArray());
+    response.getOutputStream().flush();]]></source>
+        <note>
+          Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential 
+          problems with the Acrobat Reader Plug-in in Microsoft Internet Explorer.
+        </note>
+        <p>
+          The <code>Source</code> instance used above is simply an
+          example.  If you have to read the XML from a string, supply
+          a <code>new StreamSource(new
+          StringReader(xmlstring))</code>. Constructing and reparsing
+          an XML string is generally less desirable than using a
+          SAXSource if you generate your XML.  You can alternatively
+          supply a DOMSource as well.  You may also use dynamically
+          generated XSL if you like.
+        </p>
+        <p>
+          Because you have an explicit <code>Transformer</code> object, you can also use it to 
+          explicitely set parameters for the transformation run.
+        </p>
+      </section>
+      <section id="cfg">
+        <title>Custom configuration</title>
+        <p>
+          You can easily set up your own FOUserAgent as demonstrated on the <link href="embedding.html">Embedding page</link>.
+        </p>
+      </section>
+      <section id="performance">
+        <title>Improving performance</title>
+        <p>
+          There are several options to consider:
+        </p>
+        <ul>
+          <li>
+            Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream
+            implementation from the <link href="ext:jakarta/commons/io">Jakarta Commons IO project</link> which allocates less memory.
+            The full class name is: <code>org.apache.commons.io.output.ByteArrayOutputStream</code>
+          </li>
+          <li>
+            In certain cases it can help to write the generated PDF to a temporary file so
+            you can quickly reuse the file. This is especially useful, if Internet Explorer
+            calls the servlet multiple times with the same request or if you often generate
+            equal PDFs.
+          </li>
+        </ul>
+        <p>
+          Of course, the 
+          <link href="embedding.html#performance">performance hints from the Embedding page</link>
+          apply here, too.
+        </p>
+      </section>
+    </section>
+    <section id="ie">
+      <title>Notes on Microsoft Internet Explorer</title>
+      <p>
+        Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times.
+        These are well-known limitations of Internet Explorer and are not a problem of the servlet.
+        However, Internet Explorer can still be used to download the PDF so that it can be viewed later. 
+        Here are some suggestions in this context:
+      </p>
+      <ul>
+        <li>
+          Use an URL ending in <code>.pdf</code>, like
+          <code>http://myserver/servlet/stuff.pdf</code>. Yes, the servlet can
+          be configured to handle this. If the URL has to contain parameters,
+          try to have <strong>both</strong> the base URL as well as the last parameter end in
+          <code>.pdf</code>, if necessary append a dummy parameter, like
+          <code>http://myserver/servlet/stuff.pdf?par1=a&amp;par2=b&amp;d=.pdf</code>. The
+          effect may depend on IEx version.
+        </li>
+        <li>
+          Give IEx the opportunity to cache. In particular, ensure the
+          server does not set any headers causing IEx not to cache the
+          content. This may be a real problem if the document is sent
+          over HTTPS, because most IEx installations will by default
+          <em>not</em> cache any content retrieved over HTTPS.
+          Setting the <code>Expires</code> header entry may help in
+          this case:<br/> <code>response.setDateHeader("Expires",
+          System.currentTimeMillis() + cacheExpiringDuration *
+          1000);</code><br/> Consult your server manual and the
+          relevant RFCs for further details on HTTP headers and
+          caching.
+        </li>
+        <li>
+          Cache in the server. It may help to include a parameter in
+          the URL which has a timestamp as the value min order to
+          decide whether a request is repeated. IEx is reported to
+          retrieve a document up to three times, but never more often.
+        </li>
+      </ul>
+    </section>
+    <section id="servlet-engine">
+      <title>Servlet Engines</title>
+      <p>
+        When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts 
+        with existing XML/XSLT libraries. Servlet containers also often use their own classloaders 
+        for loading webapps, which can cause bugs and security problems.
+      </p>
+      <section id="tomcat">
+        <title>Tomcat</title>
+        <p>
+          Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon.
+          There are known bugs that must be addressed, particularly for Tomcat 4.0.3.
+        </p>
+      </section>
+      <section id="websphere">
+        <title>WebSphere 3.5</title>
+        <p>
+          Put a copy of a working parser in some directory where WebSphere can access it.
+          For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, 
+          copy the Xerces jar into it (any other directory would also be fine).
+          Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the 
+          application server which contains your web application.
+          In the WebSphere administration console, click on the "environment" button in the 
+          "general" tab. In the "variable name" box, enter "CLASSPATH".
+          In the "value" box, enter the correct path to the parser jar file 
+          (/usr/webapps/yourapp/servlets/Xerces.jar in our example here).
+          Press "OK", then apply the change and restart the application server.
+        </p>
+      </section>
+    </section>
+    <section id="complex-usecases">
+      <title>Handling complex use cases</title>
+      <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 <link class="fork" href="ext:cocoon">Apache Cocoon</link> instead 
+        of a custom servlet to accomplish your goal.
+      </p>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: xmlgraphics/site/deploy/fop/0.93/servlets.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/site/deploy/fop/0.93/servlets.xml
------------------------------------------------------------------------------
    svn:keywords = Id



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


Mime
View raw message