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

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;