[pdfbox-docs] branch master updated: PDFBOX-5086: add comment about not to use input file as output when saving a pdf

[le...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

lehmi pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pdfbox-docs.git


The following commit(s) were added to refs/heads/master by this push:
     new 47f72c3  PDFBOX-5086: add comment about not to use input file as output when saving a pdf
47f72c3 is described below

commit 47f72c3d02f8ff3cdaba23d697cc2deec81508a2
Author: Andreas Lehmkühler <an...@lehmi.de>
AuthorDate: Tue Feb 16 07:56:28 2021 +0100

    PDFBOX-5086: add comment about not to use input file as output when saving a pdf
---
 content/3.0/migration.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/content/3.0/migration.md b/content/3.0/migration.md
index f6335e3..5a29178 100644
--- a/content/3.0/migration.md
+++ b/content/3.0/migration.md
@@ -67,7 +67,9 @@ When saving a PDF this will now be done in compressed mode per default. To overr
 
 PDFBox now loads a PDF Document incrementally reducing the initial memory footprint. This will also reduce the memory needed to
 consume a PDF if only certain parts of the PDF are accessed. Note that, due to the nature of PDF, uses such as iterating over all pages,
-accessing annotations, signing a PDF etc. might still load all parts of the PDF overtime leading to a similar memory consumption as with PDFBox 2.0.   
+accessing annotations, signing a PDF etc. might still load all parts of the PDF overtime leading to a similar memory consumption as with PDFBox 2.0.
+
+The input file must not be used as output for saving operations. It will corrupt the file and throw an exception as parts of the file are read the first time when saving it.
 
 ## Changes in Common Functions 
 
@@ -92,4 +94,4 @@ The command line interface for the PDFBox App has been rewritten. As a result
 - passing input and output files have been changed from using parameters to using options/flags to reduce the ambiguity
 - all commands now return an exit code
 - all commands now support passing `-h` or `--help` to display usage information
-- all commands now support passing `-V` or `--version` to display the version information
\ No newline at end of file
+- all commands now support passing `-V` or `--version` to display the version information