PDFBOX-5660: improve javadoc

THausherr · THausherr · commit 5370a0b3745c · 2025-09-16T11:11:08.000Z
git-svn-id: https://svn.apache.org/repos/asf/pdfbox/trunk@1928507 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java b/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java
@@ -1232,6 +1232,10 @@ public ExternalSigningSupport saveIncrementalForExternalSigning(OutputStream out
      *
      * @param pageIndex the 0-based page index
      * @return the page at the given index.
+     * 
+     * @throws IllegalStateException if the requested index isn't found or doesn't point to a valid
+     * page dictionary.
+     * @throws IndexOutOfBoundsException if the requested index is higher than the page count.
      */
     public PDPage getPage(int pageIndex) // todo: REPLACE most calls to this method with BELOW method
     {

Original file line number	Diff line number	Diff line change
`@@ -1232,6 +1232,10 @@ public ExternalSigningSupport saveIncrementalForExternalSigning(OutputStream out`
`1232`	`1232`	`*`
`1233`	`1233`	`* @param pageIndex the 0-based page index`
`1234`	`1234`	`* @return the page at the given index.`
	`1235`	`+ *`
	`1236`	`+ * @throws IllegalStateException if the requested index isn't found or doesn't point to a valid`
	`1237`	`+ * page dictionary.`
	`1238`	`+ * @throws IndexOutOfBoundsException if the requested index is higher than the page count.`
`1235`	`1239`	`*/`
`1236`	`1240`	`public PDPage getPage(int pageIndex) // todo: REPLACE most calls to this method with BELOW method`
`1237`	`1241`	`{`