Author: tilman
Date: Tue Apr 8 11:25:36 2025
New Revision: 1924934
URL: http://svn.apache.org/viewvc?rev=1924934&view=rev
Log:
PDFBOX-5660: clarify javadoc for SO79560213
Modified:
pdfbox/branches/3.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
Modified:
pdfbox/branches/3.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
URL:
http://svn.apache.org/viewvc/pdfbox/branches/3.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java?rev=1924934&r1=1924933&r2=1924934&view=diff
==============================================================================
---
pdfbox/branches/3.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
(original)
+++
pdfbox/branches/3.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
Tue Apr 8 11:25:36 2025
@@ -923,6 +923,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param fileName The file to save as.
*
@@ -940,6 +942,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param file The file to save as.
*
@@ -957,6 +961,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param output The stream to write to. It is recommended to wrap it in a
{@link java.io.BufferedOutputStream},
* unless it is already buffered.
@@ -975,6 +981,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param file The file to save as.
* @param compressParameters The parameters for the document's compression.
@@ -1002,6 +1010,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param fileName The file to save as.
* @param compressParameters The parameters for the document's compression.
@@ -1020,6 +1030,8 @@ public class PDDocument implements Close
* <p>
* If encryption has been activated (with {@link
#protect(org.apache.pdfbox.pdmodel.encryption.ProtectionPolicy)
* protect(ProtectionPolicy)}), do not use the document after saving
because the contents are now encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @param output The stream to write to. It is recommended to wrap it in a
{@link java.io.BufferedOutputStream},
* unless it is already buffered.
@@ -1297,6 +1309,8 @@ public class PDDocument implements Close
* previously and logs a warning.
* <p>
* Do not use the document after saving, because the structures are
encrypted.
+ * The same applies if your file was created from parts of another file
and that
+ * one is to be used after saving.
*
* @see org.apache.pdfbox.pdmodel.encryption.StandardProtectionPolicy
* @see org.apache.pdfbox.pdmodel.encryption.PublicKeyProtectionPolicy
