Hi,

the attached patch removes all warnings I got from eclipse about doc comment @param tags not matching method signatures and similar. It also documents some previously undocumented methods. Please note that my copyright assignment is pending, I'll ping this message when the paper shuffling is finished.

        Thanks,
                Carsten

ChangeLog (also attached):

2006-03-27  Carsten Neumann  <[EMAIL PROTECTED]>

        * java/sql/Time.java (Time): Fixed doc comment.
        * java/sql/Timestamp.java: Fixed doc comments.
        * java/sql/Statement.java: Fixed doc comments.
        * java/sql/SQLWarning.java (SQLWarning): Fixed doc comment.
        * java/sql/SQLOutput.java: Made the method parameter names more
        consistent and adapted doc comments.
        (writeURL): Documented.
        * java/sql/SQLData.java (readSQL): Fixed doc comment.
        * java/sql/Driver.java (connect): Fixed doc comment.
        (acceptsURL): Likewise.
        * java/sql/DriverManager.java (setLoginTimeout): Fixed doc comment.
        (setLogStream): Likewise.
        (println): Likewise.
        * java/sql/Date.java (Date): Fixed doc comment.
        * java/sql/DatabaseMetaData.java: Made the method parameter names more
        consistent and adapted doc comments.
        (supportsSavepoints): Documented.
        (supportsNamedParameters): Likewise.
        (supportsMultipleOpenResults): Likewise.
        (supportsResultSetHoldability): Likewise.
        (getResultSetHoldability): Likewise.
        (getDatabaseMajorVersion): Likewise.
        (getDatabaseMinorVersion): Likewise.
        (getJDBCMajorVersion): Likewise.
        (getJDBCMinorVersion): Likewise.
        * java/sql/Connection.java: Made the method parameter names more
        consistent and adapted doc comments.
        (setHoldability): Documented.
        (getHoldability): Likewise.
        (setSavepoint): Likewise.
        (setSavepoint): Likewise.
        (rollback): Likewise.
        (releaseSavepoint): Likewise.
        (createStatement): Likewise.
        (prepareStatement): Likewise.
        (prepareCall): Likewise.
        * java/sql/ResultSet.java: Made the method parameter names more
         consistent and adapted doc comments.
        (getURL): Documented.
        (updateRef): Likewise.
        (updateBlob): Likewise.
        (updateClob): Likewise.
        (updateArray): Likewise.
        * java/sql/ResultSetMetaData.java: Made the method parameter names more
         consistent and adapted doc comments.
        * java/sql/PreparedStatement.java: Made the method parameter names more
         consistent and adapted doc comments.
        (setURL): Documented.
        (getParameterMetaData): Likewise.
        * java/sql/Clob.java: Made the method parameter names more consistent 
and
        adapted doc comments.
        (setString): Documented.
        (setAsciiStream): Likewise.
        (setCharacterStream): Likewise.
        (truncate): Likewise.
        * java/sql/CallableStatement.java: Made the method parameter names more
        consistent and adapted doc comments.
        (getURL): Documented.
        (setURL): Likewise.
        (setNull): Likewise.
        (setBoolean): Likewise.
        (setByte): Likewise.
        (setShort): Likewise.
        (setInt): Likewise.
        (setLong): Likewise.
        (setFloat): Likewise.
        (setDouble): Likewise.
        (setBigDecimal): Likewise.
        (setString): Likewise.
        (setBytes): Likewise.
        (setDate): Likewise.
        (setTime): Likewise.
        (setTimestamp): Likewise.
        (setAsciiStream): Likewise.
        (setBinaryStream): Likewise.
        (setObject): Likewise.
        (setCharacterStream): Likewise.
        (setDate): Likewise.
        (setTime): Likewise.
        (setTimestamp): Likewise.
        (setNull): Likewise.
        (getString): Likewise.
        (getBoolean): Likewise.
        (getByte): Likewise.
        (getShort): Likewise.
        (getInt): Likewise.
        (getLong): Likewise.
        (getFloat): Likewise.
        (getDouble): Likewise.
        (getBytes): Likewise.
        (getDate): Likewise.
        (getTime): Likewise.
        (getTimestamp): Likewise.
        (getObject): Likewise.
        (getBigDecimal): Likewise.
        (getRef): Likewise.
        (getBlob): Likewise.
        (getClob): Likewise.
        (getArray): Likewise.
        (getURL): Likewise.
        * java/sql/Blob.java: Made the method parameter names more consistent 
and
        adapted doc comments.
        (setBytes): Documented.
        (setBinaryStream): Likewise.
        (truncate): Likewise.
        * java/sql/Array.java: Made the method parmater names more consistent 
and
        adapted doc comments.

Attachment: java.sql.diff.gz
Description: application/gzip

2006-03-27  Carsten Neumann  <[EMAIL PROTECTED]>

        * java/sql/Time.java (Time): Fixed doc comment.
        * java/sql/Timestamp.java: Fixed doc comments.
        * java/sql/Statement.java: Fixed doc comments.
        * java/sql/SQLWarning.java (SQLWarning): Fixed doc comment.
        * java/sql/SQLOutput.java: Made the method parameter names more
        consistent and adapted doc comments.
        (writeURL): Documented.
        * java/sql/SQLData.java (readSQL): Fixed doc comment.
        * java/sql/Driver.java (connect): Fixed doc comment.
        (acceptsURL): Likewise.
        * java/sql/DriverManager.java (setLoginTimeout): Fixed doc comment.
        (setLogStream): Likewise.
        (println): Likewise.
        * java/sql/Date.java (Date): Fixed doc comment.
        * java/sql/DatabaseMetaData.java: Made the method parameter names more
        consistent and adapted doc comments.
        (supportsSavepoints): Documented.
        (supportsNamedParameters): Likewise.
        (supportsMultipleOpenResults): Likewise.
        (supportsResultSetHoldability): Likewise.
        (getResultSetHoldability): Likewise.
        (getDatabaseMajorVersion): Likewise.
        (getDatabaseMinorVersion): Likewise.
        (getJDBCMajorVersion): Likewise.
        (getJDBCMinorVersion): Likewise.
        * java/sql/Connection.java: Made the method parameter names more
        consistent and adapted doc comments.
        (setHoldability): Documented.
        (getHoldability): Likewise.
        (setSavepoint): Likewise.
        (setSavepoint): Likewise.
        (rollback): Likewise.
        (releaseSavepoint): Likewise.
        (createStatement): Likewise.
        (prepareStatement): Likewise.
        (prepareCall): Likewise.
        * java/sql/ResultSet.java: Made the method parameter names more
         consistent and adapted doc comments.
        (getURL): Documented.
        (updateRef): Likewise.
        (updateBlob): Likewise.
        (updateClob): Likewise.
        (updateArray): Likewise.
        * java/sql/ResultSetMetaData.java: Made the method parameter names more
         consistent and adapted doc comments.
        * java/sql/PreparedStatement.java: Made the method parameter names more
         consistent and adapted doc comments.
        (setURL): Documented.
        (getParameterMetaData): Likewise.
        * java/sql/Clob.java: Made the method parameter names more consistent 
and
        adapted doc comments.
        (setString): Documented.
        (setAsciiStream): Likewise.
        (setCharacterStream): Likewise.
        (truncate): Likewise.
        * java/sql/CallableStatement.java: Made the method parameter names more
        consistent and adapted doc comments.
        (getURL): Documented.
        (setURL): Likewise.
        (setNull): Likewise.
        (setBoolean): Likewise.
        (setByte): Likewise.
        (setShort): Likewise.
        (setInt): Likewise.
        (setLong): Likewise.
        (setFloat): Likewise.
        (setDouble): Likewise.
        (setBigDecimal): Likewise.
        (setString): Likewise.
        (setBytes): Likewise.
        (setDate): Likewise.
        (setTime): Likewise.
        (setTimestamp): Likewise.
        (setAsciiStream): Likewise.
        (setBinaryStream): Likewise.
        (setObject): Likewise.
        (setCharacterStream): Likewise.
        (setDate): Likewise.
        (setTime): Likewise.
        (setTimestamp): Likewise.
        (setNull): Likewise.
        (getString): Likewise.
        (getBoolean): Likewise.
        (getByte): Likewise.
        (getShort): Likewise.
        (getInt): Likewise.
        (getLong): Likewise.
        (getFloat): Likewise.
        (getDouble): Likewise.
        (getBytes): Likewise.
        (getDate): Likewise.
        (getTime): Likewise.
        (getTimestamp): Likewise.
        (getObject): Likewise.
        (getBigDecimal): Likewise.
        (getRef): Likewise.
        (getBlob): Likewise.
        (getClob): Likewise.
        (getArray): Likewise.
        (getURL): Likewise.
        * java/sql/Blob.java: Made the method parameter names more consistent 
and
        adapted doc comments.
        (setBytes): Documented.
        (setBinaryStream): Likewise.
        (truncate): Likewise.
        * java/sql/Array.java: Made the method parmater names more consistent 
and
        adapted doc comments.

Reply via email to