FreeChainXenon/gcc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

MarshalledObject.java, [...]: Fixed javadoc, coding style and argument names all over.

Browse source 
2004-04-20  Michael Koch  <konqueror@gmx.de>

	* java/rmi/MarshalledObject.java,
	java/rmi/Naming.java,
	java/rmi/RemoteException.java,
	java/rmi/activation/ActivationException.java,
	java/rmi/server/ServerCloneException.java,
	java/security/AccessController.java,
	java/security/AlgorithmParameterGenerator.java,
	java/security/AlgorithmParameters.java,
	java/security/CodeSource.java,
	java/security/Identity.java,
	java/security/IdentityScope.java,
	java/security/KeyPairGenerator.java,
	java/security/KeyStore.java,
	java/security/Security.java,
	java/security/Signature.java,
	java/security/SignatureSpi.java,
	java/security/SignedObject.java,
	java/security/spec/DSAParameterSpec.java,
	java/security/spec/DSAPrivateKeySpec.java,
	java/security/spec/DSAPublicKeySpec.java,
	java/sql/Array.java,
	java/sql/DatabaseMetaData.java,
	java/sql/ResultSet.java,
	java/text/ChoiceFormat.java,
	java/text/CollationElementIterator.java,
	java/text/CollationKey.java,
	java/text/Collator.java,
	java/text/DateFormat.java,
	java/text/DateFormatSymbols.java,
	java/text/DecimalFormatSymbols.java,
	java/text/Format.java,
	java/text/ParsePosition.java,
	java/text/RuleBasedCollator.java,
	java/text/SimpleDateFormat.java,
	java/text/StringCharacterIterator.java,
	java/util/Collections.java,
	java/util/PropertyResourceBundle.java,
	java/util/ResourceBundle.java,
	java/util/StringTokenizer.java,
	java/util/jar/Attributes.java,
	java/util/logging/ConsoleHandler.java,
	java/util/logging/LogManager.java,
	java/util/logging/MemoryHandler.java,
	java/util/logging/SocketHandler.java,
	javax/naming/NamingException.java:
	Fixed javadoc, coding style and argument names all over.

From-SVN: r80906
This commit is contained in:
Michael Koch 2004-04-20 14:45:10 +00:00 • committed by Michael Koch
parent 386d3a1616
commit a17c9f2ea1
46 changed files with 441 additions and 386 deletions
Download patch file Download diff file Expand all files Collapse all files

49
libjava/ChangeLog
View file

@ -1,3 +1,52 @@
2004-04-20 Michael Koch <konqueror@gmx.de>
* java/rmi/MarshalledObject.java,
java/rmi/Naming.java,
java/rmi/RemoteException.java,
java/rmi/activation/ActivationException.java,
java/rmi/server/ServerCloneException.java,
java/security/AccessController.java,
java/security/AlgorithmParameterGenerator.java,
java/security/AlgorithmParameters.java,
java/security/CodeSource.java,
java/security/Identity.java,
java/security/IdentityScope.java,
java/security/KeyPairGenerator.java,
java/security/KeyStore.java,
java/security/Security.java,
java/security/Signature.java,
java/security/SignatureSpi.java,
java/security/SignedObject.java,
java/security/spec/DSAParameterSpec.java,
java/security/spec/DSAPrivateKeySpec.java,
java/security/spec/DSAPublicKeySpec.java,
java/sql/Array.java,
java/sql/DatabaseMetaData.java,
java/sql/ResultSet.java,
java/text/ChoiceFormat.java,
java/text/CollationElementIterator.java,
java/text/CollationKey.java,
java/text/Collator.java,
java/text/DateFormat.java,
java/text/DateFormatSymbols.java,
java/text/DecimalFormatSymbols.java,
java/text/Format.java,
java/text/ParsePosition.java,
java/text/RuleBasedCollator.java,
java/text/SimpleDateFormat.java,
java/text/StringCharacterIterator.java,
java/util/Collections.java,
java/util/PropertyResourceBundle.java,
java/util/ResourceBundle.java,
java/util/StringTokenizer.java,
java/util/jar/Attributes.java,
java/util/logging/ConsoleHandler.java,
java/util/logging/LogManager.java,
java/util/logging/MemoryHandler.java,
java/util/logging/SocketHandler.java,
javax/naming/NamingException.java:
Fixed javadoc, coding style and argument names all over.
2004-04-20 Jeroen Frijters <jeroen@frijters.net>
* java/io/FileDescriptor.java: (FileDescriptor) Added public

5
libjava/java/rmi/MarshalledObject.java
View file

@ -1,5 +1,5 @@
/*
Copyright (c) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
Copyright (c) 1996, 1997, 1998, 1999, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -46,8 +46,7 @@ import gnu.java.rmi.RMIMarshalledObjectOutputStream;
/**
* FIXME - doc missing
*/
public final class MarshalledObject
extends Object implements Serializable
public final class MarshalledObject implements Serializable
{
//The following fields are from Java API Documentation "Serialized form"

6
libjava/java/rmi/Naming.java
View file

@ -44,14 +44,16 @@ import java.rmi.registry.LocateRegistry;
public final class Naming {
/** <pre>
/**
* Looks for the remote object that is associated with the named service.
* Name and location is given in form of a URL without a scheme:
*
* <pre>
* //host:port/service-name
* </pre>
*
* The port is optional.
* </pre>
*
* @param name the service name and location
* @return Remote-object that implements the named service
* @throws NotBoundException if no object implements the service

2
libjava/java/rmi/RemoteException.java
View file

@ -99,7 +99,7 @@ public class RemoteException extends IOException
* This method returns a message indicating what went wrong, in this
* format:
* <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>.
* : "; nested exception is:\n\t" + detail)</code>.
*
* @return the chained message
*/

2
libjava/java/rmi/activation/ActivationException.java
View file

@ -94,7 +94,7 @@ public class ActivationException extends Exception
* This method returns a message indicating what went wrong, in this
* format:
* <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>.
* : "; nested exception is:\n\t" + detail)</code>.
*
* @return the chained message
*/

2
libjava/java/rmi/server/ServerCloneException.java
View file

@ -89,7 +89,7 @@ public class ServerCloneException extends CloneNotSupportedException
* This method returns a message indicating what went wrong, in this
* format:
* <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>.
* : "; nested exception is:\n\t" + detail)</code>.
*
* @return the chained message
*/

10
libjava/java/security/AccessController.java
View file

@ -1,5 +1,5 @@
/* AccessController.java --- Access control context and permission checker
Copyright (C) 2001 Free Software Foundation, Inc.
Copyright (C) 2001, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -91,7 +91,7 @@ public final class AccessController
*
* @param action the <code>PrivilegedAction</code> whose <code>run()</code>
* should be be called.
* @returns the result of the <code>action.run()</code> method.
* @return the result of the <code>action.run()</code> method.
*/
public static Object doPrivileged(PrivilegedAction action)
{
@ -110,7 +110,7 @@ public final class AccessController
* should be be called.
* @param context the <code>AccessControlContext</code> whose protection
* domains should be added to the protection domain of the calling class.
* @returns the result of the <code>action.run()</code> method.
* @return the result of the <code>action.run()</code> method.
*/
public static Object doPrivileged(PrivilegedAction action,
AccessControlContext context)
@ -130,7 +130,7 @@ public final class AccessController
*
* @param action the <code>PrivilegedExceptionAction</code> whose
* <code>run()</code> should be be called.
* @returns the result of the <code>action.run()</code> method.
* @return the result of the <code>action.run()</code> method.
* @exception PrivilegedActionException wrapped around any exception that
* is thrown in the <code>run()</code> method.
*/
@ -162,7 +162,7 @@ public final class AccessController
* <code>run()</code> should be be called.
* @param context the <code>AccessControlContext</code> whose protection
* domains should be added to the protection domain of the calling class.
* @returns the result of the <code>action.run()</code> method.
* @return the result of the <code>action.run()</code> method.
* @exception PrivilegedActionException wrapped around any exception that
* is thrown in the <code>run()</code> method.
*/

2
libjava/java/security/AlgorithmParameterGenerator.java
View file

@ -67,7 +67,7 @@ import gnu.java.security.Engine;
* system parameters, for example, the parameter generation values usually
* consist of the size of the prime modulus and the size of the random
* exponent, both specified in number of bits.</li>
* <ul>
* </ul>
*
* <p>In case the client does not explicitly initialize the
* <code>AlgorithmParameterGenerator</code> (via a call to an <code>init()</code>

2
libjava/java/security/AlgorithmParameters.java
View file

@ -71,7 +71,7 @@ import gnu.java.security.Engine;
* parameter specification or parameter encoding.</p>
*
* <p>A transparent parameter specification is obtained from an
* <ocde>AlgorithmParameters</code> object via a call to
* <code>AlgorithmParameters</code> object via a call to
* <code>getParameterSpec()</code>, and a byte encoding of the parameters is
* obtained via a call to <code>getEncoded()</code>.</p>
*

23
libjava/java/security/CodeSource.java
View file

@ -159,17 +159,22 @@ public class CodeSource implements Serializable
* object must have all the certifcates this object has (but may have more),
* and must have a location that is a subset of this object's. In order
* for this object to imply the specified object, the following must be
* true:<ol>
* true:
*
* <ol>
* <li><em>codesource</em> must not be <code>null</code>.</li>
* <li>If <em>codesource</em> has a certificate list, all of it's
* certificates must be present in the certificate list of this
* code source.</li>
* <li>If this object does not have a <code>null</code> location, then
* the following addtional tests must be passed.<ol>
* the following addtional tests must be passed.
*
* <ol>
* <li><em>codesource</em> must not have a <code>null</code>
* location.</li>
* <li><em>codesource</em>'s location must be equal to this object's
* location, or<br><ul>
* location, or
* <ul>
* <li><em>codesource</em>'s location protocol, port, and ref (aka,
* anchor) must equal this objects</li>
* <li><em>codesource</em>'s location host must imply this object's
@ -183,19 +188,21 @@ public class CodeSource implements Serializable
* location file must start with this object's location file
* with the '/' character appended to it.</li>
* </ul></li>
* </ol>
* </ol></li>
* </ol>
*
* <p>For example, each of these locations imply the location
* "http://java.sun.com/classes/foo.jar":<ul>
* "http://java.sun.com/classes/foo.jar":</p>
*
* <pre>
* http:
* http://*.sun.com/classes/*
* http://java.sun.com/classes/-
* http://java.sun.com/classes/foo.jar
* </pre>
* Note that the code source with null location and null certificates implies
* all other code sources.
*
* <p>Note that the code source with null location and null certificates implies
* all other code sources.</p>
*
* @param cs the <code>CodeSource</code> to test against this object
* @return true if this specified <code>CodeSource</code> is implied
@ -245,7 +252,7 @@ public class CodeSource implements Serializable
/**
* This method returns a <code>String</code> that represents this object.
* The result is in the format <code>"(" + getLocation()</code> followed
* by a space separated list of certificates (or "<no certificates>"),
* by a space separated list of certificates (or "&lt;no certificates&gt;"),
* followed by <code>")"</code>.
*
* @return a <code>String</code> for this object

2
libjava/java/security/Identity.java
View file

@ -151,7 +151,7 @@ public abstract class Identity implements Principal, Serializable
* @throws KeyManagementException if another identity in the identity's scope
* has the same public key, or if another exception occurs.
* @throws SecurityException if a security manager exists and its
* <code>checkSecurityAccess()<code> method doesn't allow setting the public
* <code>checkSecurityAccess()</code> method doesn't allow setting the public
* key.
* @see #getPublicKey()
* @see SecurityManager#checkSecurityAccess(String)

4
libjava/java/security/IdentityScope.java
View file

@ -123,7 +123,7 @@ public abstract class IdentityScope extends Identity
}
/**
* <p>Sets the system's identity scope.</p>
* Sets the system's identity scope.
*
* <p>First, if there is a security manager, its <code>checkSecurityAccess()
* </code> method is called with <code>"setSystemScope"</code> as its argument
@ -131,7 +131,7 @@ public abstract class IdentityScope extends Identity
*
* @param scope the scope to set.
* @throws SecurityException if a security manager exists and its
* <code>checkSecurityAccess()<code> method doesn't allow setting the
* <code>checkSecurityAccess()</code> method doesn't allow setting the
* identity scope.
* @see #getSystemScope()
* @see SecurityManager#checkSecurityAccess(String)

11
libjava/java/security/KeyPairGenerator.java
View file

@ -67,14 +67,14 @@ import gnu.java.security.Engine;
* {@link SecureRandom} implementation of the highest-priority installed
* provider as the <i>source of randomness</i>. (If none of the installed
* providers supply an implementation of {@link SecureRandom}, a
* system-provided source of randomness is used.)<br/><br/>
* system-provided source of randomness is used.)
*
* Since no other parameters are specified when you call the above
* <p>Since no other parameters are specified when you call the above
* algorithm-independent initialize methods, it is up to the provider what
* to do about the algorithm-specific parameters (if any) to be associated
* with each of the keys.<br/><br/>
* with each of the keys.</p>
*
* If the algorithm is the <i>DSA</i> algorithm, and the <i>keysize</i>
* <p>If the algorithm is the <i>DSA</i> algorithm, and the <i>keysize</i>
* (modulus size) is <code>512</code>, <code>768</code>, or <code>1024</code>,
* then the <b>GNU</b> provider uses a set of precomputed values for the
* <code>p</code>, <code>q</code>, and <code>g</code> parameters. If the
@ -82,8 +82,7 @@ import gnu.java.security.Engine;
* provider creates a new set of parameters. Other providers might have
* precomputed parameter sets for more than just the three modulus sizes
* mentioned above. Still others might not have a list of precomputed
* parameters at all and instead always create new parameter sets.<br/></li>
*
* parameters at all and instead always create new parameter sets.</p></li>
* <li><b>Algorithm-Specific Initialization</b><br/>
* For situations where a set of algorithm-specific parameters already
* exists (e.g., so-called <i>community parameters</i> in <i>DSA</i>), there

2
libjava/java/security/KeyStore.java
View file

@ -208,7 +208,7 @@ public class KeyStore
/**
* Returns the default KeyStore type. This method looks up the
* type in <JAVA_HOME>/lib/security/java.security with the
* type in &lt;JAVA_HOME&gt;/lib/security/java.security with the
* property "keystore.type" or if that fails then "jks" .
*/
public static final String getDefaultType()

6
libjava/java/security/Security.java
View file

@ -1,5 +1,5 @@
/* Security.java --- Java base security class implementation
Copyright (C) 1999, 2001, 2002, 2003, Free Software Foundation, Inc.
Copyright (C) 1999, 2001, 2002, 2003, 2004, Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -59,7 +59,7 @@ import java.util.Vector;
*
* @author Mark Benvenuto <ivymccough@worldnet.att.net>
*/
public final class Security extends Object
public final class Security
{
private static final String ALG_ALIAS = "Alg.Alias.";
@ -670,7 +670,7 @@ public final class Security extends Object
outer: for (int r = 0; r < 3; r++) // guard against circularity
{
serviceDotAlgorithm = (svc+"."+String.valueOf(algo)).trim();
inner: for (it = p.keySet().iterator(); it.hasNext(); )
for (it = p.keySet().iterator(); it.hasNext(); )
{
key = (String) it.next();
if (key.equalsIgnoreCase(serviceDotAlgorithm)) // eureka

2
libjava/java/security/Signature.java
View file

@ -105,7 +105,7 @@ import gnu.java.security.Engine;
* superclass are intended for cryptographic service providers who wish to
* supply their own implementations of digital signature algorithms.
*
* @author Mark Benvenuto <ivymccough@worldnet.att.net>
* @author Mark Benvenuto (ivymccough@worldnet.att.net)
*/
public abstract class Signature extends SignatureSpi
{

2
libjava/java/security/SignatureSpi.java
View file

@ -279,7 +279,7 @@ public abstract class SignatureSpi
* @param param the string name of the parameter.
* @return the object that represents the parameter value, or <code>null</code>
* if there is none.
* @throws InvalidParameterException if <code>param<?code> is an invalid
* @throws InvalidParameterException if <code>param</code> is an invalid
* parameter for this engine, or another exception occurs while trying to get
* this parameter.
* @deprecated

2
libjava/java/security/SignedObject.java
View file

@ -98,7 +98,7 @@ import java.io.Serializable;
* <p>The signature algorithm can be, among others, the NIST standard <i>DSS</i>,
* using <i>DSA</i> and <i>SHA-1</i>. The algorithm is specified using the same
* convention as that for signatures. The <i>DSA</i> algorithm using the
* </i>SHA-1</i> message digest algorithm can be specified, for example, as
* <i>SHA-1</i> message digest algorithm can be specified, for example, as
* <code>"SHA/DSA"</code> or <code>"SHA-1/DSA"</code> (they are equivalent). In
* the case of <i>RSA</i>, there are multiple choices for the message digest
* algorithm, so the signing algorithm could be specified as, for example,

4
libjava/java/security/spec/DSAParameterSpec.java
View file

@ -1,5 +1,5 @@
/* DSAParameterSpec.java --- DSA Parameter Specificaton class
Copyright (C) 1999 Free Software Foundation, Inc.
Copyright (C) 1999, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -48,7 +48,7 @@ import java.math.BigInteger;
@author Mark Benvenuto
*/
public class DSAParameterSpec extends Object implements AlgorithmParameterSpec, DSAParams
public class DSAParameterSpec implements AlgorithmParameterSpec, DSAParams
{
private BigInteger p = null;
private BigInteger q = null;

4
libjava/java/security/spec/DSAPrivateKeySpec.java
View file

@ -1,5 +1,5 @@
/* DSAPrivateKeySpec.java --- DSA Private Key Specificaton class
Copyright (C) 1999 Free Software Foundation, Inc.
Copyright (C) 1999, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -47,7 +47,7 @@ import java.math.BigInteger;
@author Mark Benvenuto
*/
public class DSAPrivateKeySpec extends Object implements KeySpec
public class DSAPrivateKeySpec implements KeySpec
{
private BigInteger x = null;
private BigInteger p = null;

4
libjava/java/security/spec/DSAPublicKeySpec.java
View file

@ -1,5 +1,5 @@
/* DSAPublicKeySpec.java --- DSA Public Key Specificaton class
Copyright (C) 1999 Free Software Foundation, Inc.
Copyright (C) 1999, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@ -47,7 +47,7 @@ import java.math.BigInteger;
@author Mark Benvenuto
*/
public class DSAPublicKeySpec extends Object implements KeySpec
public class DSAPublicKeySpec implements KeySpec
{
private BigInteger y = null;
private BigInteger p = null;

8
libjava/java/sql/Array.java
View file

@ -165,13 +165,13 @@ public interface Array
/**
* This method returns a portion of the array as a <code>ResultSet</code>.
* The returned portion will start at <code>index</code> into the
* array and up to <cod>count</code> elements will be returned.
* <p>
* Each row of the result set will have two columns. The first will be
* array and up to <code>count</code> elements will be returned.
*
* <p> Each row of the result set will have two columns. The first will be
* the index into the array of that row's contents. The second will be
* the actual value of that array element. The specified <code>Map</code>
* will be used to override selected default mappings of SQL types to
* Java classes.
* Java classes.</p>
*
* @param offset The index into the array to start returning elements from.
* @param length The requested number of elements to return.

352
libjava/java/sql/DatabaseMetaData.java
View file

@ -412,7 +412,7 @@ public interface DatabaseMetaData
* each table.
*
* @return <code>true</code> if the database uses a separate file for each
* table </code>false</code> otherwise.
* table <code>false</code> otherwise.
*
* @exception SQLException If an error occurs.
*/
@ -433,7 +433,7 @@ public interface DatabaseMetaData
* This method tests whether or not the database treats mixed case
* identifiers as all upper case.
*
* @exception <code>true</code> if the database treats all identifiers as
* @return <code>true</code> if the database treats all identifiers as
* upper case, <code>false</code> otherwise.
* @exception SQLException If an error occurs.
*/
@ -443,7 +443,7 @@ public interface DatabaseMetaData
* This method tests whether or not the database treats mixed case
* identifiers as all lower case.
*
* @exception <code>true</code> if the database treats all identifiers as
* @return <code>true</code> if the database treats all identifiers as
* lower case, <code>false</code> otherwise.
* @exception SQLException If an error occurs.
*/
@ -473,7 +473,7 @@ public interface DatabaseMetaData
* This method tests whether or not the database treats mixed case
* quoted identifiers as all upper case.
*
* @exception <code>true</code> if the database treats all quoted identifiers
* @return <code>true</code> if the database treats all quoted identifiers
* as upper case, <code>false</code> otherwise.
* @exception SQLException If an error occurs.
*/
@ -483,7 +483,7 @@ public interface DatabaseMetaData
* This method tests whether or not the database treats mixed case
* quoted identifiers as all lower case.
*
* @exception <code>true</code> if the database treats all quoted identifiers
* @return <code>true</code> if the database treats all quoted identifiers
* as lower case, <code>false</code> otherwise.
* @exception SQLException If an error occurs.
*/
@ -1377,18 +1377,18 @@ public interface DatabaseMetaData
* <p>
* <ol>
* <li>PROCEDURE_CAT - The catalog the procedure is in, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>PROCEDURE_SCHEM - The schema the procedures is in, which may be
* <code>null</code>.
* <li>PROCEDURE_NAME - The name of the procedure.
* <li>Unused
* <li>Unused
* <li>Unused
* <li>REMARKS - A description of the procedure
* <code>null</code>.</li>
* <li>PROCEDURE_NAME - The name of the procedure.</li>
* <li>Unused</li>
* <li>Unused</li>
* <li>Unused</li>
* <li>REMARKS - A description of the procedure</li>
* <li>PROCEDURE_TYPE - Indicates the return type of the procedure, which
* is one of the contstants defined in this class
* (<code>procedureResultUnknown</code>, <code>procedureNoResult</code>, or
* <code>procedureReturnsResult</code>).
* <code>procedureReturnsResult</code>).</li>
* </ol>
*
* @param catalog The name of the catalog to return stored procedured from,
@ -1409,27 +1409,27 @@ public interface DatabaseMetaData
* <p>
* <ol>
* <li>PROCEDURE_CAT - The catalog the procedure is in, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>PROCEDURE_SCHEM - The schema the procedures is in, which may be
* <code>null</code>.
* <li>PROCEDURE_NAME - The name of the procedure.
* <li>COLUMN_NAME - The name of the column
* <code>null</code>.</li>
* <li>PROCEDURE_NAME - The name of the procedure.</li>
* <li>COLUMN_NAME - The name of the column</li>
* <li>COLUMN_TYPE - The type of the column, which will be one of the
* contants defined in this class (<code>procedureColumnUnknown</code>,
* <code>procedureColumnIn</code>, <code>procedureColumnInOut</code>,
* <code>procedureColumnOut</code>, <code>procedureColumnReturn</code>,
* or <code>procedureColumnResult</code>).
* or <code>procedureColumnResult</code>).</li>
* <li>DATA_TYPE - The SQL type of the column. This is one of the constants
* defined in <code>Types</code>.
* <li>TYPE_NAME - The string name of the data type for this column.
* <li>PRECISION - The precision of the column.
* <li>LENGTH - The length of the column in bytes
* <li>SCALE - The scale of the column.
* <li>RADIX - The radix of the column.
* defined in <code>Types</code>.</li>
* <li>TYPE_NAME - The string name of the data type for this column.</li>
* <li>PRECISION - The precision of the column.</li>
* <li>LENGTH - The length of the column in bytes</li>
* <li>SCALE - The scale of the column.</li>
* <li>RADIX - The radix of the column.</li>
* <li>NULLABLE - Whether or not the column is NULLABLE. This is one of
* the constants defined in this class (<code>procedureNoNulls</code>,
* <code>procedureNullable</code>, or <code>procedureNullableUnknown</code>)
* <li>REMARKS - A description of the column.
* <code>procedureNullable</code>, or <code>procedureNullableUnknown</code>)</li>
* <li>REMARKS - A description of the column.</li>
* </ol>
*
* @param catalog The name of the catalog to return stored procedured from,
@ -1448,14 +1448,14 @@ public interface DatabaseMetaData
/**
* This method returns a list of the requested table as a
* <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>TABLE_CAT - The catalog the table is in, which may be <code>null</code>.
* <li>TABLE_SCHEM - The schema the table is in, which may be <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>TABLE_CAT - The catalog the table is in, which may be <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema the table is in, which may be <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>TABLE_TYPE - A string describing the table type. This will be one
* of the values returned by the <code>getTableTypes()</code> method.
* <li>REMARKS - Comments about the table.
* of the values returned by the <code>getTableTypes()</code> method.</li>
* <li>REMARKS - Comments about the table.</li>
* </ol>
*
* @param catalog The name of the catalog to return tables from,
@ -1507,29 +1507,29 @@ public interface DatabaseMetaData
* <p>
* <ol>
* <li>TABLE_CAT - The catalog the table is in, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema the tables is in, which may be
* <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>COLUMN_NAME - The name of the column
* <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>COLUMN_NAME - The name of the column</li>
* <li>DATA_TYPE - The SQL type of the column. This is one of the constants
* defined in <code>Types</code>.
* <li>TYPE_NAME - The string name of the data type for this column.
* <li>COLUMN_SIZE - The size of the column.
* <li>Unused
* <li>NUM_PREC_RADIX - The radix of the column.
* defined in <code>Types</code>.</li>
* <li>TYPE_NAME - The string name of the data type for this column.</li>
* <li>COLUMN_SIZE - The size of the column.</li>
* <li>Unused</li>
* <li>NUM_PREC_RADIX - The radix of the column.</li>
* <li>NULLABLE - Whether or not the column is NULLABLE. This is one of
* the constants defined in this class (<code>tableNoNulls</code>,
* <code>tableNullable</code>, or <code>tableNullableUnknown</code>)
* <li>REMARKS - A description of the column.
* <li>COLUMN_DEF - The default value for the column, may be <code>null</code>.
* <li>SQL_DATA_TYPE - Unused
* <li>SQL_DATETIME_SUB - Unused
* <code>tableNullable</code>, or <code>tableNullableUnknown</code>)</li>
* <li>REMARKS - A description of the column.</li>
* <li>COLUMN_DEF - The default value for the column, may be <code>null</code>.</li>
* <li>SQL_DATA_TYPE - Unused</li>
* <li>SQL_DATETIME_SUB - Unused</li>
* <li>CHAR_OCTET_LENGTH - For character columns, the maximum number of bytes
* in the column.
* <li>ORDINAL_POSITION - The index of the column in the table.
* in the column.</li>
* <li>ORDINAL_POSITION - The index of the column in the table.</li>
* <li>IS_NULLABLE - "NO" means no, "YES" means maybe, and an empty string
* means unknown.
* means unknown.</li>
* </ol>
*
* @param catalog The name of the catalog to return table from,
@ -1548,19 +1548,19 @@ public interface DatabaseMetaData
* This method returns the access rights that have been granted to the
* requested columns. This information is returned as a <code>ResultSet</code>
* with the following columns:
* <p>
*
* <ol>
* <li>TABLE_CAT - The catalog the table is in, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema the tables is in, which may be
* <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>COLUMN_NAME - The name of the column.
* <li>GRANTOR - The entity that granted the access.
* <li>GRANTEE - The entity granted the access.
* <li>PRIVILEGE - The name of the privilege granted.
* <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>COLUMN_NAME - The name of the column.</li>
* <li>GRANTOR - The entity that granted the access.</li>
* <li>GRANTEE - The entity granted the access.</li>
* <li>PRIVILEGE - The name of the privilege granted.</li>
* <li>IS_GRANTABLE - "YES" if the grantee can grant the privilege to
* others, "NO" if not, and <code>null</code> if unknown.
* others, "NO" if not, and <code>null</code> if unknown.</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1580,18 +1580,18 @@ public interface DatabaseMetaData
* This method returns the access rights that have been granted to the
* requested tables. This information is returned as a <code>ResultSet</code>
* with the following columns:
* <p>
*
* <ol>
* <li>TABLE_CAT - The catalog the table is in, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema the tables is in, which may be
* <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>GRANTOR - The entity that granted the access.
* <li>GRANTEE - The entity granted the access.
* <li>PRIVILEGE - The name of the privilege granted.
* <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>GRANTOR - The entity that granted the access.</li>
* <li>GRANTEE - The entity granted the access.</li>
* <li>PRIVILEGE - The name of the privilege granted.</li>
* <li>IS_GRANTABLE - "YES" if the grantee can grant the privilege to
* others, "NO" if not, and <code>null</code> if unknown.
* others, "NO" if not, and <code>null</code> if unknown.</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1611,22 +1611,22 @@ public interface DatabaseMetaData
* This method returns the best set of columns for uniquely identifying
* a row. It returns this information as a <code>ResultSet</code> with
* the following columns:
* <p>
*
* <ol>
* <li>SCOPE - The scope of the results returned. This is one of the
* constants defined in this class (<code>bestRowTemporary</code>,
* <code>bestRowTransaction</code>, or <code>bestRowSession</code>).
* <li>COLUMN_NAME - The name of the column.
* <code>bestRowTransaction</code>, or <code>bestRowSession</code>).</li>
* <li>COLUMN_NAME - The name of the column.</li>
* <li>DATA_TYPE - The SQL type of the column. This is one of the constants
* defined in <code>Types</code>.
* <li>TYPE_NAME - The string name of the data type for this column.
* <li>COLUMN_SIZE - The precision of the columns
* <li>BUFFER_LENGTH - Unused
* <li>DECIMAL_DIGITS - The scale of the column.
* defined in <code>Types</code>.</li>
* <li>TYPE_NAME - The string name of the data type for this column.</li>
* <li>COLUMN_SIZE - The precision of the columns</li>
* <li>BUFFER_LENGTH - Unused</li>
* <li>DECIMAL_DIGITS - The scale of the column.</li>
* <li>PSEUDO_COLUMN - Whether or not the best row identifier is a
* pseudo_column. This is one of the constants defined in this class
* (<code>bestRowUnknown</code>, <code>bestRowNotPseudo</code>, or
* <code>bestRowPseudo</code>).
* <code>bestRowPseudo</code>).</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1649,20 +1649,20 @@ public interface DatabaseMetaData
* This method returns the set of columns that are automatically updated
* when the row is update. It returns this information as a
* <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>SCOPE - Unused
* <li>COLUMN_NAME - The name of the column.
* <li>SCOPE - Unused</li>
* <li>COLUMN_NAME - The name of the column.</li>
* <li>DATA_TYPE - The SQL type of the column. This is one of the constants
* defined in <code>Types</code>.
* <li>TYPE_NAME - The string name of the data type for this column.
* <li>COLUMN_SIZE - The precision of the columns
* <li>BUFFER_LENGTH - Unused
* <li>DECIMAL_DIGITS - The scale of the column.
* defined in <code>Types</code>.</li>
* <li>TYPE_NAME - The string name of the data type for this column.</li>
* <li>COLUMN_SIZE - The precision of the columns</li>
* <li>BUFFER_LENGTH - Unused</li>
* <li>DECIMAL_DIGITS - The scale of the column.</li>
* <li>PSEUDO_COLUMN - Whether or not the best row identifier is a
* pseudo_column. This is one of the constants defined in this class
* (<code>versionRowUnknown</code>, <code>versionRowNotPseudo</code>, or
* <code>versionRowPseudo</code>).
* <code>versionRowPseudo</code>).</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1681,14 +1681,14 @@ public interface DatabaseMetaData
/**
* This method returns a list of a table's primary key columns. These
* are returned as a <code>ResultSet</code> with the following columns.
* <p>
*
* <ol>
* <li>TABLE_CAT - The catalog of the table, which may be <code>null</code>.
* <li>TABLE_SCHEM - The schema of the table, which may be <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>COLUMN_NAME - The name of the column.
* <li>KEY_SEQ - The sequence number of the column within the primary key.
* <li>PK_NAME - The name of the primary key, which may be <code>null</code>.
* <li>TABLE_CAT - The catalog of the table, which may be <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema of the table, which may be <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>COLUMN_NAME - The name of the column.</li>
* <li>KEY_SEQ - The sequence number of the column within the primary key.</li>
* <li>PK_NAME - The name of the primary key, which may be <code>null</code>.</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1707,32 +1707,32 @@ public interface DatabaseMetaData
/**
* This method returns a list of the table's foreign keys. These are
* returned as a <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.
* <li>PKTABLE_NAME - The name of the table the key was imported from.
* <li>PKCOLUMN_NAME - The name of the column that was imported.
* <li>FKTABLE_CAT - The foreign key catalog name.
* <li>FKTABLE_SCHEM - The foreign key schema name.
* <li>FKTABLE_NAME - The foreign key table name.
* <li>FKCOLUMN_NAME - The foreign key column name.
* <li>KEY_SEQ - The sequence number of the column within the foreign key.
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.</li>
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.</li>
* <li>PKTABLE_NAME - The name of the table the key was imported from.</li>
* <li>PKCOLUMN_NAME - The name of the column that was imported.</li>
* <li>FKTABLE_CAT - The foreign key catalog name.</li>
* <li>FKTABLE_SCHEM - The foreign key schema name.</li>
* <li>FKTABLE_NAME - The foreign key table name.</li>
* <li>FKCOLUMN_NAME - The foreign key column name.</li>
* <li>KEY_SEQ - The sequence number of the column within the foreign key.</li>
* <li>UPDATE_RULE - How the foreign key behaves when the primary key is
* updated. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, <code>importedKeySetDefault</code>, or
* <code>importedKeyRestrict</code>).
* <code>importedKeyRestrict</code>).</li>
* <li>DELETE_RULE - How the foreign key behaves when the primary key is
* deleted. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)
* <li>FK_NAME - The name of the foreign key.
* <li>PK_NAME - The name of the primary key.
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)</li>
* <li>FK_NAME - The name of the foreign key.</li>
* <li>PK_NAME - The name of the primary key.</li>
* <li>DEFERRABILITY - The deferrability value. This is one of the
* constants defined in this table (<code>importedKeyInitiallyDeferred</code>,
* <code>importedKeyInitiallyImmediate</code>, or
* <code>importedKeyNotDeferrable</code>).
* <code>importedKeyNotDeferrable</code>).</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1753,32 +1753,32 @@ public interface DatabaseMetaData
* This method returns a list of the table's which use this table's
* primary key as a foreign key. The information is
* returned as a <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.
* <li>PKTABLE_NAME - The name of the table the key was imported from.
* <li>PKCOLUMN_NAME - The name of the column that was imported.
* <li>FKTABLE_CAT - The foreign key catalog name.
* <li>FKTABLE_SCHEM - The foreign key schema name.
* <li>FKTABLE_NAME - The foreign key table name.
* <li>FKCOLUMN_NAME - The foreign key column name.
* <li>KEY_SEQ - The sequence number of the column within the foreign key.
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.</li>
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.</li>
* <li>PKTABLE_NAME - The name of the table the key was imported from.</li>
* <li>PKCOLUMN_NAME - The name of the column that was imported.</li>
* <li>FKTABLE_CAT - The foreign key catalog name.</li>
* <li>FKTABLE_SCHEM - The foreign key schema name.</li>
* <li>FKTABLE_NAME - The foreign key table name.</li>
* <li>FKCOLUMN_NAME - The foreign key column name.</li>
* <li>KEY_SEQ - The sequence number of the column within the foreign key.</li>
* <li>UPDATE_RULE - How the foreign key behaves when the primary key is
* updated. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, <code>importedKeySetDefault</code>, or
* <code>importedKeyRestrict</code>).
* <code>importedKeyRestrict</code>).</li>
* <li>DELETE_RULE - How the foreign key behaves when the primary key is
* deleted. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)
* <li>FK_NAME - The name of the foreign key.
* <li>PK_NAME - The name of the primary key.
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)</li>
* <li>FK_NAME - The name of the foreign key.</li>
* <li>PK_NAME - The name of the primary key.</li>
* <li>DEFERRABILITY - The deferrability value. This is one of the
* constants defined in this table (<code>importedKeyInitiallyDeferred</code>,
* <code>importedKeyInitiallyImmediate</code>, or
* <code>importedKeyNotDeferrable</code>).
* <code>importedKeyNotDeferrable</code>).</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -1797,32 +1797,32 @@ public interface DatabaseMetaData
* This method returns a description of how one table imports another
* table's primary key as a foreign key. The information is
* returned as a <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.
* <li>PKTABLE_NAME - The name of the table the key was imported from.
* <li>PKCOLUMN_NAME - The name of the column that was imported.
* <li>FKTABLE_CAT - The foreign key catalog name.
* <li>FKTABLE_SCHEM - The foreign key schema name.
* <li>FKTABLE_NAME - The foreign key table name.
* <li>FKCOLUMN_NAME - The foreign key column name.
* <li>KEY_SEQ - The sequence number of the column within the foreign key.
* <li>PKTABLE_CAT - The catalog of the table the key was imported from.</li>
* <li>PKTABLE_SCHEM - The schema of the table the key was imported from.</li>
* <li>PKTABLE_NAME - The name of the table the key was imported from.</li>
* <li>PKCOLUMN_NAME - The name of the column that was imported.</li>
* <li>FKTABLE_CAT - The foreign key catalog name.</li>
* <li>FKTABLE_SCHEM - The foreign key schema name.</li>
* <li>FKTABLE_NAME - The foreign key table name.</li>
* <li>FKCOLUMN_NAME - The foreign key column name.</li>
* <li>KEY_SEQ - The sequence number of the column within the foreign key.</li>
* <li>UPDATE_RULE - How the foreign key behaves when the primary key is
* updated. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, <code>importedKeySetDefault</code>, or
* <code>importedKeyRestrict</code>).
* <code>importedKeyRestrict</code>).</li>
* <li>DELETE_RULE - How the foreign key behaves when the primary key is
* deleted. This is one of the constants defined in this class
* (<code>importedNoAction</code>, <code>importedKeyCascade</code>,
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)
* <li>FK_NAME - The name of the foreign key.
* <li>PK_NAME - The name of the primary key.
* <code>importedKeySetNull</code>, or <code>importedKeySetDefault</code>)</li>
* <li>FK_NAME - The name of the foreign key.</li>
* <li>PK_NAME - The name of the primary key.</li>
* <li>DEFERRABILITY - The deferrability value. This is one of the
* constants defined in this table (<code>importedKeyInitiallyDeferred</code>,
* <code>importedKeyInitiallyImmediate</code>, or
* <code>importedKeyNotDeferrable</code>).
* <code>importedKeyNotDeferrable</code>).</li>
* </ol>
*
* @param primCatalog The catalog to retrieve information from, or the empty string
@ -1850,36 +1850,36 @@ public interface DatabaseMetaData
* This method returns a list of the SQL types supported by this
* database. The information is returned as a <code>ResultSet</code>
* with the following columns:
* <p>
*
* <ol>
* <li>TYPE_NAME - The name of the data type.
* <li>TYPE_NAME - The name of the data type.</li>
* <li>DATA_TYPE - A data type constant from <code>Types</code> for this
* type.
* <li>PRECISION - The maximum precision of this type.
* type.</li>
* <li>PRECISION - The maximum precision of this type.</li>
* <li>LITERAL_PREFIX - Prefix value used to quote a literal, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>LITERAL_SUFFIX - Suffix value used to quote a literal, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>CREATE_PARAMS - The parameters used to create the type, which may be
* <code>null</code>.
* <code>null</code>.</li>
* <li>NULLABLE - Whether or not this type supports NULL values. This will
* be one of the constants defined in this interface
* (<code>typeNoNulls</code>, <code>typeNullable</code>, or
* <code>typeNullableUnknown</code>).
* <li>CASE_SENSITIVE - Whether or not the value is case sensitive.
* <code>typeNullableUnknown</code>).</li>
* <li>CASE_SENSITIVE - Whether or not the value is case sensitive.</li>
* <li>SEARCHABLE - Whether or not "LIKE" expressions are supported in
* WHERE clauses for this type. This will be one of the constants defined
* in this interface (<code>typePredNone</code>, <code>typePredChar</code>,
* <code>typePredBasic</code>, or <code>typeSearchable</code>).
* <li>UNSIGNED_ATTRIBUTE - Is the value of this type unsigned.
* <li>FIXED_PREC_SCALE - Whether or not this type can be used for money.
* <li>AUTO_INCREMENT - Whether or not this type supports auto-incrementing.
* <li>LOCAL_TYPE_NAME - A localized name for this data type.
* <li>MINIMUM_SCALE - The minimum scale supported by this type.
* <li>MAXIMUM_SCALE - The maximum scale supported by this type.
* <li>SQL_DATA_TYPE - Unused.
* <li>SQL_DATETIME_SUB - Unused.
* <li>NUM_PREC_RADIX - The radix of this data type.
* <code>typePredBasic</code>, or <code>typeSearchable</code>).</li>
* <li>UNSIGNED_ATTRIBUTE - Is the value of this type unsigned.</li>
* <li>FIXED_PREC_SCALE - Whether or not this type can be used for money.</li>
* <li>AUTO_INCREMENT - Whether or not this type supports auto-incrementing.</li>
* <li>LOCAL_TYPE_NAME - A localized name for this data type.</li>
* <li>MINIMUM_SCALE - The minimum scale supported by this type.</li>
* <li>MAXIMUM_SCALE - The maximum scale supported by this type.</li>
* <li>SQL_DATA_TYPE - Unused.</li>
* <li>SQL_DATETIME_SUB - Unused.</li>
* <li>NUM_PREC_RADIX - The radix of this data type.</li>
* </ol>
*
* @return A <code>ResultSet</code> with the list of available data types.
@ -1890,30 +1890,30 @@ public interface DatabaseMetaData
/**
* This method returns information about a tables indices and statistics.
* It is returned as a <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>TABLE_CAT - The catalog of the table, which may be <code>null</code>.
* <li>TABLE_SCHEM - The schema of the table, which may be <code>null</code>.
* <li>TABLE_NAME - The name of the table.
* <li>NON_UNIQUE - Are index values non-unique?
* <li>INDEX_QUALIFIER The index catalog, which may be <code>null</code>
* <li>INDEX_NAME - The name of the index.
* <li>TABLE_CAT - The catalog of the table, which may be <code>null</code>.</li>
* <li>TABLE_SCHEM - The schema of the table, which may be <code>null</code>.</li>
* <li>TABLE_NAME - The name of the table.</li>
* <li>NON_UNIQUE - Are index values non-unique?</li>
* <li>INDEX_QUALIFIER The index catalog, which may be <code>null</code></li>
* <li>INDEX_NAME - The name of the index.</li>
* <li>TYPE - The type of index, which will be one of the constants defined
* in this interface (<code>tableIndexStatistic</code>,
* <code>tableIndexClustered</code>, <code>tableIndexHashed</code>, or
* <code>tableIndexOther</code>).
* <code>tableIndexOther</code>).</li>
* <li>ORDINAL_POSITION - The sequence number of this column in the index.
* This will be 0 when the index type is <code>tableIndexStatistic</code>.
* <li>COLUMN_NAME - The name of this column in the index.
* This will be 0 when the index type is <code>tableIndexStatistic</code>.</li>
* <li>COLUMN_NAME - The name of this column in the index.</li>
* <li>ASC_OR_DESC - "A" for an ascending sort sequence, "D" for a
* descending sort sequence or <code>null</code> if a sort sequence is not
* supported.
* supported.</li>
* <li>CARDINALITY - The number of unique rows in the index, or the number
* of rows in the table if the index type is <code>tableIndexStatistic</code>.
* of rows in the table if the index type is <code>tableIndexStatistic</code>.</li>
* <li>PAGES - The number of pages used for the index, or the number of pages
* in the table if the index type is <code>tableIndexStatistic</code>.
* in the table if the index type is <code>tableIndexStatistic</code>.</li>
* <li>FILTER_CONDITION - The filter condition for this index, which may be
* <code>null</code>.
* <code>null</code>.</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string
@ -2093,16 +2093,16 @@ public interface DatabaseMetaData
/**
* This method returns the list of user defined data types in use. These
* are returned as a <code>ResultSet</code> with the following columns:
* <p>
*
* <ol>
* <li>TYPE_CAT - The catalog name, which may be <code>null</code>.
* <li>TYPE_SCEHM - The schema name, which may be <code>null</code>.
* <li>TYPE_NAME - The user defined data type name.
* <li>CLASS_NAME - The Java class name this type maps to.
* <li>TYPE_CAT - The catalog name, which may be <code>null</code>.</li>
* <li>TYPE_SCEHM - The schema name, which may be <code>null</code>.</li>
* <li>TYPE_NAME - The user defined data type name.</li>
* <li>CLASS_NAME - The Java class name this type maps to.</li>
* <li>DATA_TYPE - A type identifier from <code>Types</code> for this type.
* This will be one of <code>JAVA_OBJECT</code>, <code>STRUCT</code>, or
* <code>DISTINCT</code>.
* <li>REMARKS - Comments about this data type.
* <code>DISTINCT</code>.</li>
* <li>REMARKS - Comments about this data type.</li>
* </ol>
*
* @param catalog The catalog to retrieve information from, or the empty string

14
libjava/java/sql/ResultSet.java
View file

@ -48,14 +48,14 @@ import java.util.Map;
/**
* This interface provides access to the data set returned by a SQL
* statement. An instance of this interface is returned by the various
* execution methods in the <code>Statement</code.
* <p>
* This class models a cursor, which can be stepped through one row at a
* execution methods in the <code>Statement</code>.
*
* <p> This class models a cursor, which can be stepped through one row at a
* time. Methods are provided for accessing columns by column name or by
* index.
* <p>
* Note that a result set is invalidated if the statement that returned
* it is closed.
* index.</p>
*
* <p> Note that a result set is invalidated if the statement that returned
* it is closed.</p>
*
* @author Aaron M. Renn (arenn@urbanophile.com)
*/

8
libjava/java/text/ChoiceFormat.java
View file

@ -45,7 +45,7 @@ import java.util.Vector;
* To use this class, first specify two lists of formats and range terminators.
* These lists must be arrays of equal length. The format of index
* <code>i</code> will be selected for value <code>X</code> if
* <code>terminator[i] <= X < limit[i + 1]</code>. If the value X is not
* <code>terminator[i] &lt;= X &lt; limit[i + 1]</code>. If the value X is not
* included in any range, then either the first or last format will be
* used depending on whether the value X falls outside the range.
* <p>
@ -196,10 +196,10 @@ public class ChoiceFormat extends NumberFormat
* This method tests this object for equality with the specified
* object. This will be true if and only if:
* <ul>
* <li>The specified object is not <code>null</code>.
* <li>The specified object is an instance of <code>ChoiceFormat</code>.
* <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>ChoiceFormat</code>.</li>
* <li>The termination ranges and format strings are identical to
* this object's.
* this object's. </li>
* </ul>
*
* @param obj The object to test for equality against.

2
libjava/java/text/CollationElementIterator.java
View file

@ -129,7 +129,7 @@ public final class CollationElementIterator
/**
* This method resets the internal position pointer to read from the
* beginning of the <code>String again.
* beginning of the <code>String</code> again.
*/
public void reset()
{

8
libjava/java/text/CollationKey.java
View file

@ -140,12 +140,12 @@ public final class CollationKey implements Comparable
* this object. This will be true if and only if:
* <p>
* <ul>
* <li>The specified object must not be <code>null</code>
* <li>The specified object is an instance of <code>CollationKey</code>.
* <li>The specified object must not be <code>null</code></li>
* <li>The specified object is an instance of <code>CollationKey</code>.</li>
* <li>The specified object was created from the same <code>Collator</code>
* as this object.
* as this object.</li>
* <li>The specified object has the same source string and bit key as
* this object.
* this object.</li>
* </ul>
*
* @param obj The <code>Object</code> to test for equality.

6
libjava/java/text/Collator.java
View file

@ -183,10 +183,10 @@ public abstract class Collator implements Comparator, Cloneable
* object. This will be true if and only if the following conditions are
* met:
* <ul>
* <li>The specified object is not <code>null</code>.
* <li>The specified object is an instance of <code>Collator</code>.
* <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>Collator</code>.</li>
* <li>The specified object has the same strength and decomposition
* settings as this object.
* settings as this object.</li>
* </ul>
*
* @param obj The <code>Object</code> to test for equality against

6
libjava/java/text/DateFormat.java
View file

@ -196,9 +196,9 @@ public abstract class DateFormat extends Format implements Cloneable
* object:
* <P>
* <ul>
* <li>Is not <code>null</code>.
* <li>Is an instance of <code>DateFormat</code>.
* <li>Has the same numberFormat field value as this object.
* <li>Is not <code>null</code>.</li>
* <li>Is an instance of <code>DateFormat</code>.</li>
* <li>Has the same numberFormat field value as this object.</li>
* </ul>
*
* @param obj The object to test for equality against.

30
libjava/java/text/DateFormatSymbols.java
View file

@ -245,11 +245,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* the array contains five values:
* <P>
* <ul>
* <li>0 - The non-localized time zone id string.
* <li>1 - The long name of the time zone (standard time).
* <li>2 - The short name of the time zone (standard time).
* <li>3 - The long name of the time zone (daylight savings time).
* <li>4 - the short name of the time zone (daylight savings time).
* <li>0 - The non-localized time zone id string.</li>
* <li>1 - The long name of the time zone (standard time).</li>
* <li>2 - The short name of the time zone (standard time).</li>
* <li>3 - The long name of the time zone (daylight savings time).</li>
* <li>4 - the short name of the time zone (daylight savings time).</li>
* </ul>
*
* @return The list of time zone display strings.
*/
@ -386,11 +387,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* the array contains five values:
* <P>
* <ul>
* <li>0 - The non-localized time zone id string.
* <li>1 - The long name of the time zone (standard time).
* <li>2 - The short name of the time zone (standard time).
* <li>3 - The long name of the time zone (daylight savings time).
* <li>4 - the short name of the time zone (daylight savings time).
* <li>0 - The non-localized time zone id string.</li>
* <li>1 - The long name of the time zone (standard time).</li>
* <li>2 - The short name of the time zone (standard time).</li>
* <li>3 - The long name of the time zone (daylight savings time).</li>
* <li>4 - the short name of the time zone (daylight savings time).</li>
* </ul>
*
* @return The list of time zone display strings.
*/
@ -438,15 +440,15 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* This will be true if and only if the specified object:
* <p>
* <ul>
* <li> Is not <code>null</code>.
* <li> Is an instance of <code>DateFormatSymbols</code>.
* <li> Contains identical formatting symbols to this object.
* <li> Is not <code>null</code>.</li>
* <li> Is an instance of <code>DateFormatSymbols</code>.</li>
* <li> Contains identical formatting symbols to this object.</li>
* </ul>
*
* @param obj The <code>Object</code> to test for equality against.
*
* @return <code>true</code> if the specified object is equal to this one,
* </code>false</code> otherwise.
* <code>false</code> otherwise.
*/
public boolean equals (Object obj)
{

6
libjava/java/text/DecimalFormatSymbols.java
View file

@ -167,9 +167,9 @@ public final class DecimalFormatSymbols implements Cloneable, Serializable
* regard to the specified object:
* <p>
* <ul>
* <li>It is not <code>null</code>.
* <li>It is an instance of <code>DecimalFormatSymbols</code>
* <li>All of its symbols are identical to the symbols in this object.
* <li>It is not <code>null</code>.</li>
* <li>It is an instance of <code>DecimalFormatSymbols</code>.</li>
* <li>All of its symbols are identical to the symbols in this object.</li>
* </ul>
*
* @return <code>true</code> if the specified object is equal to this

2
libjava/java/text/Format.java
View file

@ -123,7 +123,7 @@ public abstract class Format implements Serializable, Cloneable
* This method parses a <code>String</code> and converts the parsed
* contents into an <code>Object</code>.
*
* @param str The <code>String to parse.
* @param str The <code>String</code> to parse.
*
* @return The resulting <code>Object</code>.
*

6
libjava/java/text/ParsePosition.java
View file

@ -116,10 +116,10 @@ public class ParsePosition
* all of the following conditions are met.
* <p>
* <ul>
* <li>The specified object is not <code>null</code>.
* <li>The specified object is an instance of <code>ParsePosition</code>.
* <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>ParsePosition</code>.</li>
* <li>The specified object has the same index and error index as
* this object.
* this object.</li>
* </ul>
*
* @param obj The <code>Object</code> to test for equality against

26
libjava/java/text/RuleBasedCollator.java
View file

@ -56,9 +56,9 @@ import java.util.Vector;
* <p>
* Rules take the form of a <code>String</code> with the following syntax
* <ul>
* <li> Modifier: '@'
* <li> Relation: '&lt;' | ';' | ',' | '=' : <text>
* <li> Reset: '&amp;' : <text>
* <li> Modifier: '@'</li>
* <li> Relation: '&lt;' | ';' | ',' | '=' : &lt;text&gt;</li>
* <li> Reset: '&amp;' : &lt;text&gt;</li>
* </ul>
* The modifier character indicates that accents sort backward as is the
* case with French. The modifier applies to all rules <b>after</b>
@ -69,12 +69,12 @@ import java.util.Vector;
* the following meanings:
* <ul>
* <li>'&lt;' - The text argument is greater than the prior term at the primary
* difference level.
* difference level.</li>
* <li>';' - The text argument is greater than the prior term at the secondary
* difference level.
* difference level.</li>
* <li>',' - The text argument is greater than the prior term at the tertiary
* difference level.
* <li>'=' - The text argument is equal to the prior term
* difference level.</li>
* <li>'=' - The text argument is equal to the prior term</li>
* </ul>
* <p>
* As for the text argument itself, this is any sequence of Unicode
@ -131,15 +131,15 @@ import java.util.Vector;
* A <code>ParseException</code> will be thrown for any of the following
* conditions:
* <ul>
* <li>Unquoted punctuation characters in a text argument.
* <li>A relational or reset operator not followed by a text argument
* <li>Unquoted punctuation characters in a text argument.</li>
* <li>A relational or reset operator not followed by a text argument</li>
* <li>A reset operator where the text argument is not present in
* the previous rule string section.
* the previous rule string section.</li>
* </ul>
*
* @author Aaron M. Renn <arenn@urbanophile.com>
* @author Tom Tromey <tromey@cygnus.com>
* @author Guilhem Lavaux <guilhem@kaffe.org>
* @author Aaron M. Renn (arenn@urbanophile.com)
* @author Tom Tromey (tromey@cygnus.com)
* @author Guilhem Lavaux (guilhem@kaffe.org)
*/
public class RuleBasedCollator extends Collator
{

12
libjava/java/text/SimpleDateFormat.java
View file

@ -358,13 +358,13 @@ public class SimpleDateFormat extends DateFormat
* object. This will be true if and only if the specified object:
* <p>
* <ul>
* <li>Is not <code>null</code>.
* <li>Is an instance of <code>SimpleDateFormat</code>.
* <li>Is not <code>null</code>.</li>
* <li>Is an instance of <code>SimpleDateFormat</code>.</li>
* <li>Is equal to this object at the superclass (i.e., <code>DateFormat</code>)
* level.
* <li>Has the same formatting pattern.
* <li>Is using the same formatting symbols.
* <li>Is using the same century for two digit years.
* level.</li>
* <li>Has the same formatting pattern.</li>
* <li>Is using the same formatting symbols.</li>
* <li>Is using the same century for two digit years.</li>
* </ul>
*
* @param obj The object to compare for equality against.

8
libjava/java/text/StringCharacterIterator.java
View file

@ -314,10 +314,10 @@ public final class StringCharacterIterator implements CharacterIterator
* object. This will be true if and only if the specified object:
* <p>
* <ul>
* <li>is not <code>null</code>.
* <li>is an instance of <code>StringCharacterIterator</code>
* <li>has the same text as this object
* <li>has the same beginning, ending, and current index as this object.
* <li>is not <code>null</code>.</li>
* <li>is an instance of <code>StringCharacterIterator</code></li>
* <li>has the same text as this object</li>
* <li>has the same beginning, ending, and current index as this object.</li>
* </ul>
*
* @param obj The object to test for equality against.

2
libjava/java/util/Collections.java
View file

@ -54,7 +54,7 @@ import java.io.Serializable;
* are not required, to throw the {@link UnsupportedOperationException} that
* the underlying collection would throw during an attempt at modification.
* For example,
* <code>Collections.singleton("").addAll(Collections.EMPTY_SET)<code>
* <code>Collections.singleton("").addAll(Collections.EMPTY_SET)</code>
* does not throw a exception, even though addAll is an unsupported operation
* on a singleton; the reason for this is that addAll did not attempt to
* modify the set.

2
libjava/java/util/PropertyResourceBundle.java
View file

@ -54,7 +54,7 @@ import java.io.InputStream;
*
* If there is also a class for this resource and the same locale, the
* class will be chosen. The properties file should have the name of the
* resource bundle, appended with the locale (e.g. <code>_de</code) and the
* resource bundle, appended with the locale (e.g. <code>_de</code> and the
* extension <code>.properties</code>. The file should have the same format
* as for <code>Properties.load()</code>
*

25
libjava/java/util/ResourceBundle.java
View file

@ -51,7 +51,7 @@ import gnu.classpath.Configuration;
* <code>getObject</code> or <code>getString</code> on that bundle.
*
* <p>When a bundle is demanded for a specific locale, the ResourceBundle
* is searched in following order (<i>def. language<i> stands for the
* is searched in following order (<i>def. language</i> stands for the
* two letter ISO language code of the default locale (see
* <code>Locale.getDefault()</code>).
*
@ -251,18 +251,22 @@ public abstract class ResourceBundle
*
* <p>A sequence of candidate bundle names are generated, and tested in
* this order, where the suffix 1 means the string from the specified
* locale, and the suffix 2 means the string from the default locale:<ul>
* locale, and the suffix 2 means the string from the default locale:</p>
*
* <ul>
* <li>baseName + "_" + language1 + "_" + country1 + "_" + variant1</li>
* <li>baseName + "_" + language1 + "_" + country1</li>
* <li>baseName + "_" + language1</li>
* <li>baseName + "_" + language2 + "_" + country2 + "_" + variant2</li>
* <li>baseName + "_" + language2 + "_" + country2</li>
* <li>baseName + "_" + language2<li>
* <li>baseName + "_" + language2</li>
* <li>baseName</li>
* </ul>
*
* <p>In the sequence, entries with an empty string are ignored. Next,
* <code>getBundle</code> tries to instantiate the resource bundle:<ul>
* <code>getBundle</code> tries to instantiate the resource bundle:</p>
*
* <ul>
* <li>First, an attempt is made to load a class in the specified classloader
* which is a subclass of ResourceBundle, and which has a public constructor
* with no arguments, via reflection.</li>
@ -277,7 +281,7 @@ public abstract class ResourceBundle
* in the above sequence are tested in a similar manner, and if any results
* in a resource bundle, it is assigned as the parent of the first bundle
* using the <code>setParent</code> method (unless the first bundle already
* has a parent).
* has a parent).</p>
*
* <p>For example, suppose the following class and property files are
* provided: MyResources.class, MyResources_fr_CH.properties,
@ -286,10 +290,12 @@ public abstract class ResourceBundle
* all files are valid (that is, public non-abstract subclasses of
* ResourceBundle with public nullary constructors for the ".class" files,
* syntactically correct ".properties" files). The default locale is
* Locale("en", "UK").
* Locale("en", "UK").</p>
*
* <p>Calling getBundle with the shown locale argument values instantiates
* resource bundles from the following sources:<ul>
* resource bundles from the following sources:</p>
*
* <ul>
* <li>Locale("fr", "CH"): result MyResources_fr_CH.class, parent
* MyResources_fr.properties, parent MyResources.class</li>
* <li>Locale("fr", "FR"): result MyResources_fr.properties, parent
@ -301,8 +307,9 @@ public abstract class ResourceBundle
* <li>Locale("es", "ES"): result MyResources_es_ES.class, parent
* MyResources.class</li>
* </ul>
* The file MyResources_fr_CH.properties is never used because it is hidden
* by MyResources_fr_CH.class.
*
* <p>The file MyResources_fr_CH.properties is never used because it is hidden
* by MyResources_fr_CH.class.</p>
*
* @param baseName the name of the ResourceBundle
* @param locale A locale

4
libjava/java/util/StringTokenizer.java
View file

@ -196,7 +196,7 @@ public class StringTokenizer implements Enumeration
/**
* This does the same as hasMoreTokens. This is the
* <code>Enumeration</code interface method.
* <code>Enumeration</code> interface method.
*
* @return true, if the next call of nextElement() will succeed
* @see #hasMoreTokens()
@ -208,7 +208,7 @@ public class StringTokenizer implements Enumeration
/**
* This does the same as nextTokens. This is the
* <code>Enumeration</code interface method.
* <code>Enumeration</code> interface method.
*
* @return the next token with respect to the current delimiter characters
* @throws NoSuchElementException if there are no more tokens

27
libjava/java/util/jar/Attributes.java
View file

@ -85,17 +85,18 @@ public class Attributes implements Cloneable, Map
* attributes, applet attributes, extension identification attributes,
* package versioning and sealing attributes, file contents attributes,
* bean objects attribute and signing attributes. See the
* <p>
* The characters of a Name must obey the following restrictions:
*
* <p>The characters of a Name must obey the following restrictions:</p>
*
* <ul>
* <li> Must contain at least one character
* <li> The first character must be alphanumeric (a-z, A-Z, 0-9)
* <li> All other characters must be alphanumeric, a '-' or a '_'
* <li>Must contain at least one character</li>
* <li>The first character must be alphanumeric (a-z, A-Z, 0-9)</li>
* <li>All other characters must be alphanumeric, a '-' or a '_'</li>
* </ul>
* <p>
* When comparing Names (with <code>equals</code>) all characters are
*
* <p>When comparing Names (with <code>equals</code>) all characters are
* converted to lowercase. But you can get the original case sensitive
* string with the <code>toString()</code> method.
* string with the <code>toString()</code> method.</p>
*
* @since 1.2
* @author Mark Wielaard (mark@klomp.org)
@ -145,15 +146,15 @@ public class Attributes implements Cloneable, Map
* Manifest manifest file with the following Names:
* <ul>
* <li> &lt;extension&gt;-Extension-Name:
* unique name of the extension
* unique name of the extension</li>
* <li> &lt;extension&gt;-Specification-Version:
* minimum specification version
* minimum specification version</li>
* <li> &lt;extension&gt;-Implementation-Version:
* minimum implementation version
* minimum implementation version</li>
* <li> &lt;extension&gt;-Implementation-Vendor-Id:
* unique id of implementation vendor
* unique id of implementation vendor</li>
* <li> &lt;extension&gt;-Implementation-URL:
* where the latest version of the extension library can be found
* where the latest version of the extension library can be found</li>
* </ul>
*/
public static final Name EXTENSION_LIST = new Name("Extension-List");

2
libjava/java/util/logging/ConsoleHandler.java
View file

@ -67,7 +67,7 @@ package java.util.logging;
*
* <li><code>java.util.logging.ConsoleHandler.encoding</code> - specifies
* the name of the character encoding. Default value:
* the default platform encoding.
* the default platform encoding.</li>
*
* </ul>
*

10
libjava/java/util/logging/LogManager.java
View file

@ -67,13 +67,12 @@ import java.lang.ref.WeakReference;
* <code>java.util.logging.LogManager</code> is initialized.
* The configuration process includes the subsequent steps:
*
* <ol>
* <ul>
* <li>If the system property <code>java.util.logging.manager</code>
* is set to the name of a subclass of
* <code>java.util.logging.LogManager</code>, an instance of
* that subclass is created and becomes the global LogManager.
* Otherwise, a new instance of LogManager is created.</li>
*
* <li>The <code>LogManager</code> constructor tries to create
* a new instance of the class specified by the system
* property <code>java.util.logging.config.class</code>.
@ -91,14 +90,13 @@ import java.lang.ref.WeakReference;
* {@link #readConfiguration(java.io.InputStream)}.
* The name and location of this file are specified by the system
* property <code>java.util.logging.config.file</code>.</li>
*
* <li>If the system property <code>java.util.logging.config.file</code>
* is not set, however, the contents of the URL
* "{gnu.classpath.home.url}/logging.properties" are passed to
* {@link #readConfiguration(java.io.InputStream)}.
* Here, "{gnu.classpath.home.url}" stands for the value of
* the system property <code>gnu.classpath.home.url</code>.</li>
* </ol>
* </ul>
*
* @author Sascha Brawer (brawer@acm.org)
*/
@ -259,10 +257,10 @@ public class LogManager
*
* @param logger the logger to be added.
*
* @return <code>true<code>if <code>logger</code> was added,
* @return <code>true</code>if <code>logger</code> was added,
* <code>false</code> otherwise.
*
* @throws NullPointerException if <code>name<code> is
* @throws NullPointerException if <code>name</code> is
* <code>null</code>.
*/
public synchronized boolean addLogger(Logger logger)

11
libjava/java/util/logging/MemoryHandler.java
View file

@ -35,10 +35,7 @@ module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
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.
*/
exception statement from your version. */
package java.util.logging;
@ -53,28 +50,22 @@ package java.util.logging;
* value, a default is taken without an exception being thrown.
*
* <ul>
*
* <li><code>java.util.MemoryHandler.level</code> - specifies
* the initial severity level threshold. Default value:
* <code>Level.ALL</code>.</li>
*
* <li><code>java.util.MemoryHandler.filter</code> - specifies
* the name of a Filter class. Default value: No Filter.</li>
*
* <li><code>java.util.MemoryHandler.size</code> - specifies the
* maximum number of log records that are kept in the circular
* buffer. Default value: 1000.</li>
*
* <li><code>java.util.MemoryHandler.push</code> - specifies the
* <code>pushLevel</code>. Default value:
* <code>Level.SEVERE</code>.</li>
*
* <li><code>java.util.MemoryHandler.target</code> - specifies the
* name of a subclass of {@link Handler} that will be used as the
* target handler. There is no default value for this property;
* if it is not set, the no-argument MemoryHandler constructor
* will throw an exception.</li>
*
* </ul>
*
* @author Sascha Brawer (brawer@acm.org)

2
libjava/java/util/logging/SocketHandler.java
View file

@ -68,7 +68,7 @@ package java.util.logging;
*
* <li><code>java.util.SocketHandler.encoding</code> - specifies
* the name of the character encoding. Default value:
* the default platform encoding.
* the default platform encoding.</li>
*
* <li><code>java.util.SocketHandler.host</code> - specifies
* the name of the host to which records are published.

4
libjava/javax/naming/NamingException.java
View file

@ -93,7 +93,7 @@ public class NamingException extends Exception
/**
* Creates a new NamingException without a message. Does not set any of the
* <code>rootException</code>, <code>resolvedName</code>,
* <code>resolvedObj</code> or <code>remainingObject,<code> fields.
* <code>resolvedObj</code> or <code>remainingObject</code> fields.
* These fields can be set later.
*/
public NamingException ()
@ -104,7 +104,7 @@ public class NamingException extends Exception
/**
* Creates a new NamingException with a detailed message. Does not set
* the <code>rootException</code>, <code>resolvedName</code>,
* <code>resolvedObj</code> or <code>remainingObject,<code> fields.
* <code>resolvedObj</code> or <code>remainingObject,</code> fields.
* These fields can be set later.
*/
public NamingException (String msg)