pdfbox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From til...@apache.org
Subject svn commit: r1731095 - /pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
Date Thu, 18 Feb 2016 16:53:32 GMT
Author: tilman
Date: Thu Feb 18 16:53:31 2016
New Revision: 1731095

URL: http://svn.apache.org/viewvc?rev=1731095&view=rev
Log:
PDFBOX-2852: clarify javadoc

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=1731095&r1=1731094&r2=1731095&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 Thu Feb 18
16:53:31 2016
@@ -500,8 +500,13 @@ public class PDDocument implements Close
      * This will import and copy the contents from another location. Currently the content
stream is stored in a scratch
      * file. The scratch file is associated with the document. If you are adding a page to
this document from another
      * document and want to copy the contents to this document's scratch file then use this
method otherwise just use
-     * the addPage method.
+     * the {@link #addPage} method.
      * 
+     * Unlike {@link #addPage}, this method does a deep copy. If your page has annotations,
and if
+     * these link to pages not in the target document, then the target document might become
huge.
+     * What you need to do is to delete page references of such annotations. See
+     * <a href="http://stackoverflow.com/a/35477351/535646">here</a> for how
to do this.
+     *
      * @param page The page to import.
      * @return The page that was imported.
      * 



Mime
View raw message