javadoc cleanup

h2/src/main/org/h2/engine/SessionInterface.java

@@ -8,6 +8,7 @@ package org.h2.engine;
 import java.io.Closeable;
 import java.util.ArrayList;
 import org.h2.command.CommandInterface;
+import org.h2.jdbc.JdbcConnection;
 import org.h2.message.Trace;
 import org.h2.store.DataHandler;
 import org.h2.value.Value;
@@ -141,7 +142,7 @@ public interface SessionInterface extends Closeable {
     boolean isRemote();
 
     /**
-     * Set current schema as in {@link JdbcConnection#setSchema(String)}.
+     * Set current schema as in {@link org.h2.jdbc.JdbcConnection#setSchema(String)}.
      *
      * @param schema the schema name
      */

h2/src/main/org/h2/mvstore/MVStore.java

@@ -917,7 +917,7 @@ public class MVStore {
     /**
      * Whether the chunk at the given position is live.
      *
-     * @param the chunk id
+     * @param chunkId the chunk id
      * @return true if it is live
      */
     boolean isChunkLive(int chunkId) {

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

@@ -329,7 +329,7 @@ public class MVSecondaryIndex extends BaseIndex implements MVIndex {
     /**
      * Convert array of values to a SearchRow.
      *
-     * @param array the index key
+     * @param key the index key
      * @return the row
      */
     SearchRow convertToSearchRow(ValueArray key) {

h2/src/main/org/h2/store/fs/FilePathMem.java

@@ -17,7 +17,6 @@ import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.TreeMap;
-
 import org.h2.api.ErrorCode;
 import org.h2.compress.CompressLZF;
 import org.h2.message.DbException;
@@ -554,8 +553,8 @@ class FileMemData {
     /**
      * Compress the data in a byte array.
      *
-     * @param data the page array
      * @param page which page to compress
+     * @param old the page array
      */
     void compress(int page, byte[] old) {
         byte[][] array = data;

h2/src/main/org/h2/util/LazyFuture.java

@@ -14,7 +14,6 @@ import org.h2.message.DbException;
 /**
  * Single threaded lazy future.
  *
- * @param <T>
  * @author Sergi Vladykin
  */
 public abstract class LazyFuture<T> implements Future<T> {

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

@@ -22,12 +22,6 @@ public class TestUsingIndex extends TestBase {
     private Connection conn;
     private Statement stat;
 
-    /**
-     * Run just this test.
-     *
-     * @param a ignored
-     * @throws java.lang.Exception
-     */
     public static void main(String... a) throws Exception {
         TestBase.createCaller().init().test();
     }

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

@@ -11,12 +11,10 @@ import java.net.Socket;
 import java.util.HashSet;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
-
 import javax.net.ssl.SSLContext;
 import javax.net.ssl.SSLServerSocket;
 import javax.net.ssl.SSLSession;
 import javax.net.ssl.SSLSocket;
-
 import org.h2.engine.SysProperties;
 import org.h2.test.TestBase;
 import org.h2.util.NetUtils;
@@ -57,7 +55,6 @@ public class TestNetUtils extends TestBase {
      * With default settings, H2 client SSL socket should be able to connect
      * to an H2 server SSL socket using an anonymous cipher suite
      * (no SSL certificate is needed).
-     * @throws Exception
      */
     private void testAnonymousTlsSession() throws Exception {
         assertTrue("Failed assumption: the default value of ENABLE_ANONYMOUS_TLS" +
@@ -98,7 +95,6 @@ public class TestNetUtils extends TestBase {
      * does not allow anonymous TLS.
      * The global property ENABLE_ANONYMOUS_TLS cannot be modified for the test;
      * instead, the server socket is altered.
-     * @throws Exception
      */
     private void testTlsSessionWithServerSideAnonymousDisabled() throws Exception {
         boolean ssl = true;

h2/src/tools/org/h2/android/H2Database.java

@@ -622,9 +622,10 @@ public class H2Database {
     /**
      * TODO
      *
-     * @deprecated
+     * @deprecated deprecated in API Level 3, use yieldIfContendedSafely
      * @return TODO
      */
+    @Deprecated
     public boolean yieldIfContended() {
         return false;
     }

h2/src/tools/org/h2/dev/fs/ArchiveTool.java

@@ -1092,8 +1092,6 @@ public class ArchiveTool {
 
         /**
          * Print the progress.
-         *
-         * @param current the current value
          */
         void printProgress(long offset) {
             current += offset;

h2/src/tools/org/h2/dev/hash/IntPerfectHash.java

@@ -91,7 +91,6 @@ public class IntPerfectHash {
      *
      * @param pos the start position
      * @param x the key
-     * @param isRoot whether this is the root of the tree
      * @param level the level
      * @return the hash value
      */