src/share/classes/javax/sql/rowset/JdbcRowSet.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2003, 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -36,11 +36,11 @@
  * The standard interface that all standard implementations of
  * <code>JdbcRowSet</code> must implement.
  *
  * <h3>1.0 Overview</h3>
  * A wrapper around a <code>ResultSet</code> object that makes it possible
- * to use the result set as a JavaBeans<sup><font size=-2>TM</font></sup>
+ * to use the result set as a JavaBeans&trade;
  * component.  Thus, a <code>JdbcRowSet</code> object can be one of the Beans that
  * a tool makes available for composing an application.  Because
  * a <code>JdbcRowSet</code> is a connected rowset, that is, it continually
  * maintains its connection to a database using a JDBC technology-enabled
  * driver, it also effectively makes the driver a JavaBeans component.

@@ -111,11 +111,11 @@
  * affect the rows in the result set, which is effectively a JavaBeans
  * component.
  * <P>
  * The implementation of the <code>RowSet</code> method <code>execute</code> in the
  * <code>JdbcRowSet</code> reference implementation differs from that in the
- * <code>CachedRowSet</code><sup><font size=-2>TM</font></sup>
+ * <code>CachedRowSet</code>&trade;
  * reference implementation to account for the different
  * requirements of connected and disconnected <code>RowSet</code> objects.
  * <p>
  *
  * @author Jonathan Bruce

@@ -236,10 +236,11 @@
     * be executed and committed as individual transactions. Otherwise, its
     * SQL statements are grouped into transactions that are terminated by a
     * call to either the method commit or the method rollback. By default,
     * new connections are in auto-commit mode.
     *
+    * @return {@code true} if auto-commit is enabled; {@code false} otherwise
     * @throws SQLException if a database access error occurs
     * @see java.sql.Connection#getAutoCommit()
     */
     public boolean getAutoCommit() throws SQLException;
 

@@ -249,11 +250,12 @@
     * the original <code>ResultSet</code> or JDBC properties passed to it. This
     * method wraps the <code>Connection</code>'s <code>getAutoCommit</code> method
     * to allow an application to set the <code>JdbcRowSet</code> transaction behavior.
     * <p>
     * Sets the current auto-commit mode for this <code>Connection</code> object.
-    *
+    * @param autoCommit {@code true} to enable auto-commit; {@code false} to
+    * disable auto-commit
     * @throws SQLException if a database access error occurs
     * @see java.sql.Connection#setAutoCommit(boolean)
     */
     public void setAutoCommit(boolean autoCommit) throws SQLException;
 

@@ -275,11 +277,11 @@
      * Each <code>JdbcRowSet</code> contains a <code>Connection</code> object from
      * the original <code>ResultSet</code> or JDBC properties passed to it.
      * Undoes all changes made in the current transaction to the last set savepoint
      * and releases any database locks currently held by this <code>Connection</code>
      * object. This method should be used only when auto-commit mode has been disabled.
-     *
+     * @param s The {@code Savepoint} to rollback to
      * @throws SQLException if a database access error occurs or this <code>Connection</code>
      * object within this <code>JdbcRowSet</code> is in auto-commit mode.
      * @see #rollback
      */
     public void rollback(Savepoint s) throws SQLException;