Documentation

h2/src/docsrc/html/features.html

@@ -780,8 +780,9 @@ In a GUI, or in an XML file, only one backslash is required:
 />
 </pre>
 <p>
-Backslashed within the init script (for example within a runscript statement, to specify the folder names in Windows) 
-would need to be escaped as well (using a backslash). It might be simpler to avoid backslashes in folder names for this reason.
+Backslashes within the init script (for example within a runscript statement, to specify the folder names in Windows)
+need to be escaped as well (using a second backslash). It might be simpler to avoid backslashes in folder names for this reason;
+use forward slashes instead.
 </p>
 
 <h2 id="ignore_unknown_settings">Ignore Unknown Settings</h2>

h2/src/tools/org/h2/build/doc/dictionary.txt

@@ -698,4 +698,4 @@ minecraft videos youtube dataflyer bukkit alessio adamo jacopo angel leon frost
 deserializing eckenfelder daniel serodio dirname semicolons whose stretch
 stabilize succeeded widening optimise deprecate increasing leaning rotate git
 hub rewind spawn shimizu fumiyuki nelson github laird rollover millions
-ljnelson edugility
+ljnelson edugility sormula pushed backslashes slashes
\ No newline at end of file

h2/src/tools/org/h2/dev/store/btree/Page.java

@@ -32,8 +32,9 @@ class Page {
      * Create a new page.
      *
      * @param map the map
-     * @param key the keys
+     * @param keys the keys
      * @param values the values
+     * @param children the children
      * @return the page
      */
     static Page create(BtreeMap<?, ?> map, Object[] keys, Object[] values, long[] children) {
@@ -111,6 +112,12 @@ class Page {
         this.id = id;
     }
 
+    /**
+     * Get the value for the given key, or null if not found.
+     *
+     * @param key the key
+     * @return the value or null
+     */
     Object find(Object key) {
         int x = findKey(key);
         if (children != null) {
@@ -148,10 +155,25 @@ class Page {
      * A position in a cursor
      */
     static class CursorPos {
+
+        /**
+         * The current page.
+         */
         Page page;
+
+        /**
+         * The current index.
+         */
         int index;
     }
 
+    /**
+     * Go to the first element for the given key.
+     *
+     * @param p the current page
+     * @param parents the stack of parent page positions
+     * @param key the key
+     */
     static void min(Page p, ArrayList<CursorPos> parents, Object key) {
         int todo;
         while (p != null) {
@@ -180,6 +202,12 @@ class Page {
         }
     }
 
+    /**
+     * Get the next key.
+     *
+     * @param parents the stack of parent page positions
+     * @return the next key
+     */
     public static Object nextKey(ArrayList<CursorPos> parents) {
         int todoTest;
         if (parents.size() == 0) {
@@ -390,7 +418,7 @@ class Page {
         return p;
     }
 
-    void insert(int index, Object key, Object value, long child) {
+    private void insert(int index, Object key, Object value, long child) {
         Object[] newKeys = new Object[keys.length + 1];
         copyWithGap(keys, newKeys, keys.length, index);
         newKeys[index] = key;
@@ -409,7 +437,7 @@ class Page {
         }
     }
 
-    void remove(int index) {
+    private void remove(int index) {
         Object[] newKeys = new Object[keys.length - 1];
         copyExcept(keys, newKeys, keys.length, index);
         keys = newKeys;
@@ -493,10 +521,6 @@ class Page {
      */
     int lengthIncludingTempChildren() {
         int len = length();
-if (len > 1024) {
-    int test;
-    System.out.println("??");
-}
         if (children != null) {
             int size = children.length;
             for (int i = 0; i < size; i++) {
@@ -509,6 +533,12 @@ if (len > 1024) {
         return len;
     }
 
+    /**
+     * Update the page ids recursively.
+     *
+     * @param pageId the new page id
+     * @return the next page id
+     */
     long updatePageIds(long pageId) {
         this.storedId = pageId;
         pageId += length();
@@ -524,6 +554,12 @@ if (len > 1024) {
         return pageId;
     }
 
+    /**
+     * Store this page.
+     *
+     * @param buff the target buffer
+     * @return the page id
+     */
     long storeTemp(ByteBuffer buff) {
         write(buff);
         if (children != null) {
@@ -539,6 +575,11 @@ if (len > 1024) {
         return id;
     }
 
+    /**
+     * Count the temporary pages recursively.
+     *
+     * @return the number of temporary pages
+     */
     int countTemp() {
         int count = 1;
         if (children != null) {
@@ -598,8 +639,4 @@ if (len > 1024) {
         }
     }
 
-    public Object getKey(int index) {
-        return keys[index];
-    }
-
 }