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

3 files changed, 15 insertions, 3 deletions

diff --git a/src/documentation/content/xdocs/0.20.5/output.xml b/src/documentation/content/xdocs/0.20.5/output.xml
index 0e4da30b8..ac9eb357b 100644
--- 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 500d31f3d..d2aed60b3 100644
--- 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 500d31f3d..d2aed60b3 100644
--- 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