Bugzilla #37589:

Added note about iText's PDFStamper.
Submitted by: Jens Stavnstrup <js@ddre.dk>

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@348211 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/documentation/content/xdocs/0.20.5/output.xml b/src/documentation/content/xdocs/0.20.5/output.xml
index 0e4da30b885c11b30670d0d35e079ee3c2b78664..ac9eb357bb333921f649bb025f53576eb20e33a4 100644 (file)
--- a/src/documentation/content/xdocs/0.20.5/output.xml
+++ b/src/documentation/content/xdocs/0.20.5/output.xml
@@ -98,7 +98,11 @@ guaranteed to be available in all PDF viewer applications."</em>
     <p>FOP does not currently support several desirable PDF features: document properties (title, author, etc.), and watermarks. One workaround is to use Adobe Acrobat (the full version, not the Reader) to process the file manually or with scripting that it supports.</p>
     <p>Another popular post-processing tool is <link href="http://www.lowagie.com/iText">iText</link>, which has tools for adding security features, document properties, watermarks, and many other features to PDF files.
     </p>
-    <warning>Caveat: iText swallows PDF bookmarks.</warning>
+    <warning>
+      Caveat: iText may swallow PDF bookmarks. But 
+      <link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37589">Jens Stavnstrup tells us</link>
+      that this doesn't happen if you use iText's PDFStamper.
+    </warning>
     <p>Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now supports <link href="pdfencryption.html">PDF encryption</link>. However the principles for using iText for other PDF features are similar.)</p>
     <source><![CDATA[public static void main(String args[]) {
   try {

diff --git a/src/documentation/content/xdocs/0.90/output.xml b/src/documentation/content/xdocs/0.90/output.xml
index 500d31f3d4deb3d216e860df214ce9cb18e08771..d2aed60b3818538526b699c1b657e1b6c9174bdb 100644 (file)
--- a/src/documentation/content/xdocs/0.90/output.xml
+++ b/src/documentation/content/xdocs/0.90/output.xml
@@ -111,7 +111,11 @@ out = proc.getOutputStream();]]></source>
           which has tools for adding security features, document properties, watermarks, and many 
           other features to PDF files.
         </p>
-        <warning>Caveat: iText may swallow PDF bookmarks.</warning>
+        <warning>
+          Caveat: iText may swallow PDF bookmarks. But 
+          <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37589">Jens Stavnstrup tells us</a>
+          that this doesn't happen if you use iText's PDFStamper.
+        </warning>
         <p>
           Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now 
           supports <a href="pdfencryption.html">PDF encryption</a>. However the principles for using 

diff --git a/src/documentation/content/xdocs/trunk/output.xml b/src/documentation/content/xdocs/trunk/output.xml
index 500d31f3d4deb3d216e860df214ce9cb18e08771..d2aed60b3818538526b699c1b657e1b6c9174bdb 100644 (file)
--- a/src/documentation/content/xdocs/trunk/output.xml
+++ b/src/documentation/content/xdocs/trunk/output.xml
@@ -111,7 +111,11 @@ out = proc.getOutputStream();]]></source>
           which has tools for adding security features, document properties, watermarks, and many 
           other features to PDF files.
         </p>
-        <warning>Caveat: iText may swallow PDF bookmarks.</warning>
+        <warning>
+          Caveat: iText may swallow PDF bookmarks. But 
+          <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37589">Jens Stavnstrup tells us</a>
+          that this doesn't happen if you use iText's PDFStamper.
+        </warning>
         <p>
           Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now 
           supports <a href="pdfencryption.html">PDF encryption</a>. However the principles for using