Update javadoc of properly implemented methods

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

@@ -1141,12 +1141,13 @@ public class JdbcConnection extends TraceObject
     }
 
     /**
-     * Creates a new prepared statement. This method just calls
-     * prepareStatement(String sql) internally. The method getGeneratedKeys only
-     * supports one column.
+     * Creates a new prepared statement.
      *
      * @param sql the SQL statement
-     * @param autoGeneratedKeys ignored
+     * @param autoGeneratedKeys
+     *            {@link Statement.RETURN_GENERATED_KEYS} if generated keys should
+     *            be available for retrieval, {@link Statement.NO_GENERATED_KEYS} if
+     *            generated keys should not be available
      * @return the prepared statement
      * @throws SQLException if the connection is closed
      */
@@ -1173,12 +1174,12 @@ public class JdbcConnection extends TraceObject
     }
 
     /**
-     * Creates a new prepared statement. This method just calls
-     * prepareStatement(String sql) internally. The method getGeneratedKeys only
-     * supports one column.
+     * Creates a new prepared statement.
      *
      * @param sql the SQL statement
-     * @param columnIndexes ignored
+     * @param columnIndexes
+     *            an array of column indexes indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the prepared statement
      * @throws SQLException if the connection is closed
      */
@@ -1204,12 +1205,12 @@ public class JdbcConnection extends TraceObject
     }
 
     /**
-     * Creates a new prepared statement. This method just calls
-     * prepareStatement(String sql) internally. The method getGeneratedKeys only
-     * supports one column.
+     * Creates a new prepared statement.
      *
      * @param sql the SQL statement
-     * @param columnNames ignored
+     * @param columnNames
+     *            an array of column names indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the prepared statement
      * @throws SQLException if the connection is closed
      */

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

@@ -903,11 +903,12 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param autoGeneratedKeys ignored
+     * @param autoGeneratedKeys
+     *            {@link Statement.RETURN_GENERATED_KEYS} if generated keys should
+     *            be available for retrieval, {@link Statement.NO_GENERATED_KEYS} if
+     *            generated keys should not be available
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -929,11 +930,12 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param autoGeneratedKeys ignored
+     * @param autoGeneratedKeys
+     *            {@link Statement.RETURN_GENERATED_KEYS} if generated keys should
+     *            be available for retrieval, {@link Statement.NO_GENERATED_KEYS} if
+     *            generated keys should not be available
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -954,11 +956,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnIndexes ignored
+     * @param columnIndexes
+     *            an array of column indexes indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -979,11 +981,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnIndexes ignored
+     * @param columnIndexes
+     *            an array of column indexes indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -1004,11 +1006,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnNames ignored
+     * @param columnNames
+     *            an array of column names indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -1029,11 +1031,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls executeUpdate(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnNames ignored
+     * @param columnNames
+     *            an array of column names indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -1054,11 +1056,12 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls execute(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param autoGeneratedKeys ignored
+     * @param autoGeneratedKeys
+     *            {@link Statement.RETURN_GENERATED_KEYS} if generated keys should
+     *            be available for retrieval, {@link Statement.NO_GENERATED_KEYS} if
+     *            generated keys should not be available
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -1079,11 +1082,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls execute(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnIndexes ignored
+     * @param columnIndexes
+     *            an array of column indexes indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)
@@ -1104,11 +1107,11 @@ public class JdbcStatement extends TraceObject implements Statement, JdbcStateme
 
     /**
      * Executes a statement and returns the update count.
-     * This method just calls execute(String sql) internally.
-     * The method getGeneratedKeys supports at most one columns and row.
      *
      * @param sql the SQL statement
-     * @param columnNames ignored
+     * @param columnNames
+     *            an array of column names indicating the columns with generated
+     *            keys that should be returned from the inserted row
      * @return the update count (number of row affected by an insert,
      *         update or delete, or 0 if no rows or the statement was a
      *         create, drop, commit or rollback)