Reformat JDBC classes and add new JDK 1.4 classes and methods.

	* java/sql/ParameterMetaData.java, java/sql/SQLPermission.java,
	java/sql/Savepoint.java: New files.
	* java/sql/Array.java, java/sql/BatchUpdateException.java,
	java/sql/Blob.java, java/sql/CallableStatement.java,
	java/sql/Clob.java, java/sql/Connection.java,
	java/sql/DataTruncation.java, java/sql/DatabaseMetaData.java,
	java/sql/Date.java, java/sql/Driver.java,
	java/sql/DriverManager.java,
	java/sql/DriverPropertyInfo.java, java/sql/PreparedStatement.java,
	java/sql/Ref.java, java/sql/ResultSet.java,
	java/sql/ResultSetMetaData.java, java/sql/SQLData.java
	java/sql/SQLException.java, java/sql/SQLInput.java,
	java/sql/SQLOutput.java, java/sql/SQLWarning.java
	java/sql/Statement.java, java/sql/Struct.java, java/sql/Time.java,
	java/sql/Timestamp.java, java/sql/Types.java: Updated to JDBC 3.0
	(JDK 1.4) specification.
	* javax/sql/ConnectionEvent.java,
	javax/sql/ConnectionEventListener.java,
	javax/sql/ConnectionPoolDataSource.java,
	javax/sql/DataSource.java, javax/sql/PooledConnection.java,
	javax/sql/RowSetEvent.java, javax/sql/RowSetInternal.java,
	javax/sql/RowSet.java, javax/sql/RowSetListener.java,
	javax/sql/RowSetMetaData.java, javax/sql/RowSetReader.java,
	javax/sql/RowSetWriter.java, javax/sql/XAConnection.java,
	javax/sql/XADataSource.java: New files.
	* java/sql/Makefile.am: Add new files.
	* javax/sql/Makefile.am: New.
	* javax/sql/package.html: New.

1 files changed, 42 insertions, 48 deletions

diff --git a/java/sql/DataTruncation.java b/java/sql/DataTruncation.java
index fb4035cb4..9892cd034 100644
--- a/java/sql/DataTruncation.java
+++ b/java/sql/DataTruncation.java
@@ -1,4 +1,4 @@
-/* DataTruncation.java -- warning when data has been truncated
+/* DataTruncation.java -- Warning when data has been truncated.
    Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
@@ -7,7 +7,7 @@ GNU Classpath is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2, or (at your option)
 any later version.
-
+ 
 GNU Classpath is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
@@ -35,73 +35,62 @@ this exception to your version of the library, but you are not
 obligated to do so.  If you do not wish to do so, delete this
 exception statement from your version. */
 
-
 package java.sql;
 
 /**
- * This exception is thrown when a piece of data is unexpectedly
- * truncated in JDBC. This has an SQLstate of <code>01004</code>.
- *
- * @author Aaron M. Renn (arenn@urbanophile.com)
- * @status updated to 1.4
- */
-public class DataTruncation extends SQLWarning
+  * This exception is thrown when a piece of data is unexpectedly 
+  * truncated in JDBC.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  */
+public class DataTruncation extends SQLWarning 
 {
-  /**
-   * Compatible with JDK 1.1+.
-   */
-  private static final long serialVersionUID = 6464298989504059473L;
+  static final long serialVersionUID = 6464298989504059473L;
 
   /**
    * The original size of the data.
-   *
-   * @serial the original data size
    */
-  private final int dataSize;
+  private int dataSize;
 
   /**
    * The index of the parameter or column whose value was truncated.
-   *
-   * @serial the index that was truncated
    */
-  private final int index;
+  private int index;
 
   /**
    * Indicates whether or not a parameter value was truncated.
-   *
-   * @serial true if a parameter was truncated
    */
-  private final boolean parameter;
+  private boolean parameter;
 
   /**
    * Indicates whether or not a data column value was truncated.
-   *
-   * @serial true if a data column was read before truncation
    */
-  private final boolean read;
+  private boolean read;
 
   /**
    * This is the size of the data after truncation.
-   *
-   * @serial the size actually transferred
    */
-  private final int transferSize;
+  private int transferSize;
 
   /**
-   * Create a new instance with the specified values.  The descriptive error
-   * message for this exception will be "Data truncation", the SQL state
-   * will be "01004", and the vendor specific error code will be set to 0.
+   * This method initializes a new instance of <code>DataTruncation</code>
+   * with the specified values.  The descriptive error message for this 
+   * exception will be "Data truncation", the SQL state will be "01004"
+   * and the vendor specific error code will be set to 0.
    *
-   * @param index the index of the parameter or column that was truncated
-   * @param parameter <code>true</code> if a parameter was truncated
-   * @param read <code>true</code> if a data column was truncated
-   * @param dataSize the original size of the data
-   * @param transferSize the size of the data after truncation
+   * @param index The index of the parameter or column that was truncated.
+   * @param parameter <code>true</code> if a parameter was truncated,
+   *        <code>false</code> otherwise.
+   * @param read <code>true</code> if a data column was truncated,
+   *        <code>false</code> otherwise.
+   * @param dataSize The original size of the data.
+   * @param transferSize The size of the data after truncation.
    */
-  public DataTruncation(int index, boolean parameter, boolean read,
-                        int dataSize, int transferSize)
+  public DataTruncation(int index, boolean parameter, boolean read, int
+    dataSize, int transferSize)
   {
     super("Data truncation", "01004");
+
     this.index = index;
     this.parameter = parameter;
     this.read = read;
@@ -110,9 +99,10 @@ public class DataTruncation extends SQLWarning
   }
 
   /**
-   * Get the index of the column or parameter that was truncated.
+   * This method returns the index of the column or parameter that was
+   * truncated.
    *
-   * @return the index of the column or parameter that was truncated
+   * @return The index of the column or parameter that was truncated.
    */
   public int getIndex()
   {
@@ -120,9 +110,11 @@ public class DataTruncation extends SQLWarning
   }
 
   /**
-   * Return true if it was a parameter that was truncated.
+   * This method determines whether or not it was a parameter that was
+   * truncated.
    *
-   * @return <code>true</code> if a parameter was truncated
+   * @return <code>true</code> if a parameter was truncated, <code>false</code>
+   * otherwise.
    */
   public boolean getParameter()
   {
@@ -130,9 +122,11 @@ public class DataTruncation extends SQLWarning
   }
 
   /**
-   * Return true if it was a column that was truncated.
+   * This method determines whether or not it was a column that was
+   * truncated.
    *
-   * @return <code>true</code> if a column was truncated
+   * @return <code>true</code> if a column was truncated, <code>false</code>
+   * otherwise.
    */
   public boolean getRead()
   {
@@ -143,7 +137,7 @@ public class DataTruncation extends SQLWarning
    * This method returns the original size of the parameter or column that
    * was truncated.
    *
-   * @return the original size
+   * @return The original size of the parameter or column that was truncated.
    */
   public int getDataSize()
   {
@@ -154,10 +148,10 @@ public class DataTruncation extends SQLWarning
    * This method returns the size of the parameter or column after it was
    * truncated.
    *
-   * @return the truncated size
+   * @return The size of the parameter or column after it was truncated.
    */
   public int getTransferSize()
   {
     return transferSize;
   }
-} // class DataTruncation
+}