[aXSL-commit] SF.net SVN: axsl:[2993] trunk/axsl/axsl-pdf/src/main/ java/org/axsl/pdf/PdfIndirectReference.java

[<vic...@us...>]

Revision: 2993
          http://sourceforge.net/p/axsl/code/2993
Author:   victormote
Date:     2026-03-25 19:14:13 +0000 (Wed, 25 Mar 2026)
Log Message:
-----------
Doc changes only.

Modified Paths:
--------------
    trunk/axsl/axsl-pdf/src/main/java/org/axsl/pdf/PdfIndirectReference.java

Modified: trunk/axsl/axsl-pdf/src/main/java/org/axsl/pdf/PdfIndirectReference.java
===================================================================
--- trunk/axsl/axsl-pdf/src/main/java/org/axsl/pdf/PdfIndirectReference.java	2026-03-25 16:44:55 UTC (rev 2992)
+++ trunk/axsl/axsl-pdf/src/main/java/org/axsl/pdf/PdfIndirectReference.java	2026-03-25 19:14:13 UTC (rev 2993)
@@ -32,6 +32,11 @@
     /**
      * Returns the object number of the referenced object.
      * @return The object number of the referenced object.
+     * @apiNote When stored in a cross-reference table, the capacity defined in the PDF reference is 10 decimal digits,
+     * a maximum of 9,999,999,999, about 5 times as much as can be stored in an {@link Integer#TYPE}.
+     * However, since {@link Integer#TYPE} defines the maximum size of a Java array, we limit the capacity to that
+     * constraint.
+     * @see "PDF Reference, Sixth Edition, Section 3.4.3."
      */
     int getObjectNumber();
 
@@ -38,6 +43,11 @@
     /**
      * Returns the generation number of the referenced object.
      * @return The generation number of the referenced object.
+     * @apiNote When stored in a cross-reference table, the capacity defined in the PDF reference is 5 decimal digits, a
+     * maximum of 99,999, about 3 times as much as can be stored in an {@link Short#TYPE}, and about 1.5 times as much
+     * as can be stored in a {@link Character#TYPE}.
+     * Therefore we use {@link Integer#TYPE}.
+     * @see "PDF Reference, Sixth Edition, Section 3.4.3."
      */
     int getObjectGeneration();
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.