Javadoc, spellcheck, formatting.

h2/src/docsrc/html/changelog.html

@@ -49,9 +49,9 @@ Change Log
 </li><li>Add support for in-memory spatial index.
 </li><li>change the PageStore#changeCount field from an int to a long,
     to cope with databases with very high transaction rates.
-</li><li>Fix NPE when attempting to add foreign key reference to Table View.
+</li><li>Fix a NullPointerException when attempting to add foreign key reference to a view.
 </li><li>Add sufficient ClientInfo support to our javax.sql.Connection implementation to make WebSphere happy.
-</li><li>Issue 482: class LobStorageBackend$LobInputStream does not override method int avalaible() from InputStream.
+</li><li>Issue 482: class LobStorageBackend$LobInputStream does not override the method InputStream.available().
 </li></ul>
 
 <h2>Version 1.3.172 (2013-05-25)</h2>

h2/src/main/org/h2/jdbc/JdbcConnection.java

@@ -1602,6 +1602,9 @@ public class JdbcConnection extends TraceObject implements Connection {
     /**
      * Set a client property.
      * This method always throws a SQLClientInfoException.
+     *
+     * @param name the name of the property (ignored)
+     * @param value the value (ignored)
      */
     @Override
     public void setClientInfo(String name, String value)
@@ -1614,6 +1617,8 @@ public class JdbcConnection extends TraceObject implements Connection {
     /**
      * Set the client properties.
      * This method always throws a SQLClientInfoException.
+     *
+     * @param properties the properties (ignored)
      */
     @Override
     public void setClientInfo(Properties properties) throws SQLClientInfoException {
@@ -1625,6 +1630,8 @@ public class JdbcConnection extends TraceObject implements Connection {
     /**
      * Get the client properties.
      * This method always returns null.
+     *
+     * @return always null
      */
     @Override
     public Properties getClientInfo() throws SQLClientInfoException {
@@ -1636,6 +1643,9 @@ public class JdbcConnection extends TraceObject implements Connection {
     /**
      * Set a client property.
      * This method always throws a SQLClientInfoException.
+     *
+     * @param name the client info name (ignored)
+     * @return this method never returns normally
      */
     @Override
     public String getClientInfo(String name) throws SQLException {

h2/src/main/org/h2/mvstore/db/MVTableEngine.java

@@ -164,6 +164,12 @@ public class MVTableEngine implements TableEngine {
             }
         }
 
+        /**
+         * Prepare a transaction.
+         *
+         * @param session the session
+         * @param transactionName the transaction name (may be null)
+         */
         public void prepareCommit(Session session, String transactionName) {
             Transaction t = session.getTransaction();
             t.setName(transactionName);

h2/src/test/org/h2/test/db/TestMultiConn.java

@@ -18,6 +18,9 @@ import org.h2.util.Task;
  */
 public class TestMultiConn extends TestBase {
 
+    /**
+     * How long to wait in milliseconds.
+     */
     static int wait;
 
     /**

h2/src/test/org/h2/test/jdbc/TestDatabaseEventListener.java

@@ -22,8 +22,11 @@ import org.h2.test.TestBase;
  */
 public class TestDatabaseEventListener extends TestBase {
 
-    private static boolean calledOpened, calledClosingDatabase, calledScan, calledCreateIndex;
-    private static boolean calledStatementStart, calledStatementEnd, calledStatementProgress;
+    /**
+     * A flag to mark that the given method was called.
+     */
+    static boolean calledOpened, calledClosingDatabase, calledScan, calledCreateIndex, 
+        calledStatementStart, calledStatementEnd, calledStatementProgress;
 
     /**
      * Run just this test.
@@ -238,6 +241,9 @@ public class TestDatabaseEventListener extends TestBase {
         assertTrue(calledStatementProgress);
     }
 
+    /**
+     * The database event listener for this test.
+     */
     public static final class MyDatabaseEventListener implements DatabaseEventListener {
 
         @Override

h2/src/test/org/h2/test/unit/TestExit.java

@@ -22,9 +22,9 @@ import org.h2.test.utils.SelfDestructor;
  */
 public class TestExit extends TestBase {
 
-    public static Connection conn;
+    private static Connection conn;
 
-    static final int OPEN_WITH_CLOSE_ON_EXIT = 1, OPEN_WITHOUT_CLOSE_ON_EXIT = 2;
+    private static final int OPEN_WITH_CLOSE_ON_EXIT = 1, OPEN_WITHOUT_CLOSE_ON_EXIT = 2;
 
     @Override
     public void test() throws Exception {
@@ -104,6 +104,8 @@ public class TestExit extends TestBase {
         conn = open(url);
         Connection conn2 = open(url);
         conn2.close();
+        // do not close
+        conn.isClosed();
     }
 
     private static Connection open(String url) throws SQLException {

h2/src/test/org/h2/test/unit/TestPageStore.java

@@ -32,6 +32,9 @@ import org.h2.util.New;
  */
 public class TestPageStore extends TestBase {
 
+    /**
+     * The events log.
+     */
     static StringBuilder eventBuffer = new StringBuilder();
 
     /**

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

@@ -730,4 +730,4 @@ customizers retains scalability assuming gili cancelled departments juerg
 franklin indicated offending unimplemented executors dumping variants
 presence spiess azeckoski aaron cowwoc decompiles canceling vividsolutions
 quadtree envelope geometry polygon typname intersects wkt intersects wkb
-coordinate geometric rates cope
+coordinate geometric rates cope attempting sphere