You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ti...@apache.org on 2018/10/23 17:03:08 UTC
svn commit: r1844680 -
/pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
Author: tilman
Date: Tue Oct 23 17:03:08 2018
New Revision: 1844680
URL: http://svn.apache.org/viewvc?rev=1844680&view=rev
Log:
PDFBOX-3017: make comment even scarier, as suggested by mkl in SO 52942313 comment
Modified:
pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
Modified: pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
URL: http://svn.apache.org/viewvc/pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java?rev=1844680&r1=1844679&r2=1844680&view=diff
==============================================================================
--- pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java (original)
+++ pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java Tue Oct 23 17:03:08 2018
@@ -1251,8 +1251,9 @@ public class PDDocument implements Close
* Save the PDF as an incremental update. This is only possible if the PDF was loaded from a
* file or a stream, not if the document was created in PDFBox itself.
*
- * @param output stream to write to. It will be closed when done. It should <i><b>not</b></i>
- * point to the source file.
+ * @param output stream to write to. It will be closed when done. It
+ * <i><b>must never</b></i> point to the source file or that one will be
+ * harmed!
* @throws IOException if the output could not be written
* @throws IllegalStateException if the document was not loaded from a file or a stream.
*/
@@ -1296,8 +1297,9 @@ public class PDDocument implements Close
* {@code PDDocument} instance and only AFTER {@link ExternalSigningSupport} instance is used.
* </p>
*
- * @param output stream to write the final PDF. It should <i><b>not</b></i> point to the source
- * file. It will be closed when the document is closed.
+ * @param output stream to write the final PDF. It will be closed when the
+ * document is closed. It <i><b>must never</b></i> point to the source file
+ * or that one will be harmed!
* @return instance to be used for external signing and setting CMS signature
* @throws IOException if the output could not be written
* @throws IllegalStateException if the document was not loaded from a file or a stream or