Have more useful information on how the different IDs are used

git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@389284 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/scratchpad/src/org/apache/poi/hslf/record/SlidePersistAtom.java b/src/scratchpad/src/org/apache/poi/hslf/record/SlidePersistAtom.java
index 7c93494fc23b6fe2ddbe3e7a889b07227c57cb82..95e5e8ad7cfa2afdeb4404bf84c91b80f6b2ab87 100644 (file)
--- a/src/scratchpad/src/org/apache/poi/hslf/record/SlidePersistAtom.java
+++ b/src/scratchpad/src/org/apache/poi/hslf/record/SlidePersistAtom.java
@@ -34,12 +34,18 @@ public class SlidePersistAtom extends RecordAtom
        private byte[] _header;
        private static long _type = 1011l;
 
-       /** Slide reference ID. A machine readable "page id" */
+       /** 
+        * Slide reference ID. Should correspond to the PersistPtr 
+        *  "sheet ID" of the matching slide/notes record 
+        */
        private int refID;
        private boolean hasShapesOtherThanPlaceholders;
        /** Number of placeholder texts that will follow in the SlideListWithText */
        private int numPlaceholderTexts;
-       /** Less useful identifier */
+       /** 
+        * The internal identifier (256+), which is used to tie slides
+        *  and notes together 
+        */
        private int slideIdentifier;
        /** Reserved fields. Who knows what they do */
        private byte[] reservedFields;