Commit a17c9f2e by Michael Koch Committed by Michael Koch

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

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
parent 386d3a16
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> 2004-04-20 Jeroen Frijters <jeroen@frijters.net>
* java/io/FileDescriptor.java: (FileDescriptor) Added public * java/io/FileDescriptor.java: (FileDescriptor) Added public
......
/* /*
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. This file is part of GNU Classpath.
...@@ -46,8 +46,7 @@ import gnu.java.rmi.RMIMarshalledObjectOutputStream; ...@@ -46,8 +46,7 @@ import gnu.java.rmi.RMIMarshalledObjectOutputStream;
/** /**
* FIXME - doc missing * FIXME - doc missing
*/ */
public final class MarshalledObject public final class MarshalledObject implements Serializable
extends Object implements Serializable
{ {
//The following fields are from Java API Documentation "Serialized form" //The following fields are from Java API Documentation "Serialized form"
......
...@@ -44,14 +44,16 @@ import java.rmi.registry.LocateRegistry; ...@@ -44,14 +44,16 @@ import java.rmi.registry.LocateRegistry;
public final class Naming { public final class Naming {
/** <pre> /**
* Looks for the remote object that is associated with the named service. * 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: * Name and location is given in form of a URL without a scheme:
* *
* //host:port/service-name * <pre>
* //host:port/service-name
* </pre>
* *
* The port is optional. * The port is optional.
* </pre> *
* @param name the service name and location * @param name the service name and location
* @return Remote-object that implements the named service * @return Remote-object that implements the named service
* @throws NotBoundException if no object implements the service * @throws NotBoundException if no object implements the service
......
...@@ -99,7 +99,7 @@ public class RemoteException extends IOException ...@@ -99,7 +99,7 @@ public class RemoteException extends IOException
* This method returns a message indicating what went wrong, in this * This method returns a message indicating what went wrong, in this
* format: * format:
* <code>super.getMessage() + (detail == null ? "" * <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>. * : "; nested exception is:\n\t" + detail)</code>.
* *
* @return the chained message * @return the chained message
*/ */
......
...@@ -94,7 +94,7 @@ public class ActivationException extends Exception ...@@ -94,7 +94,7 @@ public class ActivationException extends Exception
* This method returns a message indicating what went wrong, in this * This method returns a message indicating what went wrong, in this
* format: * format:
* <code>super.getMessage() + (detail == null ? "" * <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>. * : "; nested exception is:\n\t" + detail)</code>.
* *
* @return the chained message * @return the chained message
*/ */
......
...@@ -89,7 +89,7 @@ public class ServerCloneException extends CloneNotSupportedException ...@@ -89,7 +89,7 @@ public class ServerCloneException extends CloneNotSupportedException
* This method returns a message indicating what went wrong, in this * This method returns a message indicating what went wrong, in this
* format: * format:
* <code>super.getMessage() + (detail == null ? "" * <code>super.getMessage() + (detail == null ? ""
* : "; nested exception is:\n\t" + detail)<code>. * : "; nested exception is:\n\t" + detail)</code>.
* *
* @return the chained message * @return the chained message
*/ */
......
/* AccessController.java --- Access control context and permission checker /* 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. This file is part of GNU Classpath.
...@@ -91,7 +91,7 @@ public final class AccessController ...@@ -91,7 +91,7 @@ public final class AccessController
* *
* @param action the <code>PrivilegedAction</code> whose <code>run()</code> * @param action the <code>PrivilegedAction</code> whose <code>run()</code>
* should be be called. * 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) public static Object doPrivileged(PrivilegedAction action)
{ {
...@@ -110,7 +110,7 @@ public final class AccessController ...@@ -110,7 +110,7 @@ public final class AccessController
* should be be called. * should be be called.
* @param context the <code>AccessControlContext</code> whose protection * @param context the <code>AccessControlContext</code> whose protection
* domains should be added to the protection domain of the calling class. * 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, public static Object doPrivileged(PrivilegedAction action,
AccessControlContext context) AccessControlContext context)
...@@ -130,7 +130,7 @@ public final class AccessController ...@@ -130,7 +130,7 @@ public final class AccessController
* *
* @param action the <code>PrivilegedExceptionAction</code> whose * @param action the <code>PrivilegedExceptionAction</code> whose
* <code>run()</code> should be be called. * <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 * @exception PrivilegedActionException wrapped around any exception that
* is thrown in the <code>run()</code> method. * is thrown in the <code>run()</code> method.
*/ */
...@@ -162,7 +162,7 @@ public final class AccessController ...@@ -162,7 +162,7 @@ public final class AccessController
* <code>run()</code> should be be called. * <code>run()</code> should be be called.
* @param context the <code>AccessControlContext</code> whose protection * @param context the <code>AccessControlContext</code> whose protection
* domains should be added to the protection domain of the calling class. * 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 * @exception PrivilegedActionException wrapped around any exception that
* is thrown in the <code>run()</code> method. * is thrown in the <code>run()</code> method.
*/ */
......
...@@ -67,7 +67,7 @@ import gnu.java.security.Engine; ...@@ -67,7 +67,7 @@ import gnu.java.security.Engine;
* system parameters, for example, the parameter generation values usually * system parameters, for example, the parameter generation values usually
* consist of the size of the prime modulus and the size of the random * consist of the size of the prime modulus and the size of the random
* exponent, both specified in number of bits.</li> * exponent, both specified in number of bits.</li>
* <ul> * </ul>
* *
* <p>In case the client does not explicitly initialize the * <p>In case the client does not explicitly initialize the
* <code>AlgorithmParameterGenerator</code> (via a call to an <code>init()</code> * <code>AlgorithmParameterGenerator</code> (via a call to an <code>init()</code>
......
...@@ -71,7 +71,7 @@ import gnu.java.security.Engine; ...@@ -71,7 +71,7 @@ import gnu.java.security.Engine;
* parameter specification or parameter encoding.</p> * parameter specification or parameter encoding.</p>
* *
* <p>A transparent parameter specification is obtained from an * <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 * <code>getParameterSpec()</code>, and a byte encoding of the parameters is
* obtained via a call to <code>getEncoded()</code>.</p> * obtained via a call to <code>getEncoded()</code>.</p>
* *
......
...@@ -159,17 +159,22 @@ public class CodeSource implements Serializable ...@@ -159,17 +159,22 @@ public class CodeSource implements Serializable
* object must have all the certifcates this object has (but may have more), * 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 * 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 * 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><em>codesource</em> must not be <code>null</code>.</li>
* <li>If <em>codesource</em> has a certificate list, all of it's * <li>If <em>codesource</em> has a certificate list, all of it's
* certificates must be present in the certificate list of this * certificates must be present in the certificate list of this
* code source.</li> * code source.</li>
* <li>If this object does not have a <code>null</code> location, then * <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> * <li><em>codesource</em> must not have a <code>null</code>
* location.</li> * location.</li>
* <li><em>codesource</em>'s location must be equal to this object's * <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, * <li><em>codesource</em>'s location protocol, port, and ref (aka,
* anchor) must equal this objects</li> * anchor) must equal this objects</li>
* <li><em>codesource</em>'s location host must imply this object's * <li><em>codesource</em>'s location host must imply this object's
...@@ -183,19 +188,21 @@ public class CodeSource implements Serializable ...@@ -183,19 +188,21 @@ public class CodeSource implements Serializable
* location file must start with this object's location file * location file must start with this object's location file
* with the '/' character appended to it.</li> * with the '/' character appended to it.</li>
* </ul></li> * </ul></li>
* </ol> * </ol></li>
* </ol> * </ol>
* *
* <p>For example, each of these locations imply the location * <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> * <pre>
* http: * http:
* http://*.sun.com/classes/* * http://*.sun.com/classes/*
* http://java.sun.com/classes/- * http://java.sun.com/classes/-
* http://java.sun.com/classes/foo.jar * http://java.sun.com/classes/foo.jar
* </pre> * </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 * @param cs the <code>CodeSource</code> to test against this object
* @return true if this specified <code>CodeSource</code> is implied * @return true if this specified <code>CodeSource</code> is implied
...@@ -245,7 +252,7 @@ public class CodeSource implements Serializable ...@@ -245,7 +252,7 @@ public class CodeSource implements Serializable
/** /**
* This method returns a <code>String</code> that represents this object. * This method returns a <code>String</code> that represents this object.
* The result is in the format <code>"(" + getLocation()</code> followed * 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>. * followed by <code>")"</code>.
* *
* @return a <code>String</code> for this object * @return a <code>String</code> for this object
......
...@@ -151,7 +151,7 @@ public abstract class Identity implements Principal, Serializable ...@@ -151,7 +151,7 @@ public abstract class Identity implements Principal, Serializable
* @throws KeyManagementException if another identity in the identity's scope * @throws KeyManagementException if another identity in the identity's scope
* has the same public key, or if another exception occurs. * has the same public key, or if another exception occurs.
* @throws SecurityException if a security manager exists and its * @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. * key.
* @see #getPublicKey() * @see #getPublicKey()
* @see SecurityManager#checkSecurityAccess(String) * @see SecurityManager#checkSecurityAccess(String)
......
...@@ -123,7 +123,7 @@ public abstract class IdentityScope extends Identity ...@@ -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() * <p>First, if there is a security manager, its <code>checkSecurityAccess()
* </code> method is called with <code>"setSystemScope"</code> as its argument * </code> method is called with <code>"setSystemScope"</code> as its argument
...@@ -131,7 +131,7 @@ public abstract class IdentityScope extends Identity ...@@ -131,7 +131,7 @@ public abstract class IdentityScope extends Identity
* *
* @param scope the scope to set. * @param scope the scope to set.
* @throws SecurityException if a security manager exists and its * @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. * identity scope.
* @see #getSystemScope() * @see #getSystemScope()
* @see SecurityManager#checkSecurityAccess(String) * @see SecurityManager#checkSecurityAccess(String)
......
...@@ -56,43 +56,42 @@ import gnu.java.security.Engine; ...@@ -56,43 +56,42 @@ import gnu.java.security.Engine;
* two is the initialization of the object:</p> * two is the initialization of the object:</p>
* *
* <ul> * <ul>
* <li><b>Algorithm-Independent Initialization</b><br/> * <li><b>Algorithm-Independent Initialization</b><br/>
* All key pair generators share the concepts of a <i>keysize</i> and a * All key pair generators share the concepts of a <i>keysize</i> and a
* <i>source of randomness</i>. The <i>keysize</i> is interpreted differently * <i>source of randomness</i>. The <i>keysize</i> is interpreted differently
* for different algorithms (e.g., in the case of the <i>DSA</i> algorithm, * for different algorithms (e.g., in the case of the <i>DSA</i> algorithm,
* the <i>keysize</i> corresponds to the length of the modulus). There is an * the <i>keysize</i> corresponds to the length of the modulus). There is an
* <code>initialize()</code> method in this <code>KeyPairGenerator</code> * <code>initialize()</code> method in this <code>KeyPairGenerator</code>
* class that takes these two universally shared types of arguments. There * class that takes these two universally shared types of arguments. There
* is also one that takes just a <i>keysize</i> argument, and uses the * is also one that takes just a <i>keysize</i> argument, and uses the
* {@link SecureRandom} implementation of the highest-priority installed * {@link SecureRandom} implementation of the highest-priority installed
* provider as the <i>source of randomness</i>. (If none of the installed * provider as the <i>source of randomness</i>. (If none of the installed
* providers supply an implementation of {@link SecureRandom}, a * 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 * algorithm-independent initialize methods, it is up to the provider what
* to do about the algorithm-specific parameters (if any) to be associated * 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>, * (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 * 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 * <code>p</code>, <code>q</code>, and <code>g</code> parameters. If the
* <i>modulus size</i> is not one of the above values, the <b>GNU</b> * <i>modulus size</i> is not one of the above values, the <b>GNU</b>
* provider creates a new set of parameters. Other providers might have * provider creates a new set of parameters. Other providers might have
* precomputed parameter sets for more than just the three modulus sizes * precomputed parameter sets for more than just the three modulus sizes
* mentioned above. Still others might not have a list of precomputed * 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/>
* <li><b>Algorithm-Specific Initialization</b><br/> * For situations where a set of algorithm-specific parameters already
* For situations where a set of algorithm-specific parameters already * exists (e.g., so-called <i>community parameters</i> in <i>DSA</i>), there
* exists (e.g., so-called <i>community parameters</i> in <i>DSA</i>), there * are two initialize methods that have an {@link AlgorithmParameterSpec}
* are two initialize methods that have an {@link AlgorithmParameterSpec} * argument. One also has a {@link SecureRandom} argument, while the the
* argument. One also has a {@link SecureRandom} argument, while the the * other uses the {@link SecureRandom} implementation of the highest-priority
* other uses the {@link SecureRandom} implementation of the highest-priority * installed provider as the source of randomness. (If none of the installed
* installed provider as the source of randomness. (If none of the installed * providers supply an implementation of {@link SecureRandom}, a
* providers supply an implementation of {@link SecureRandom}, a * system-provided source of randomness is used.)</li>
* system-provided source of randomness is used.)</li>
* </ul> * </ul>
* *
* <p>In case the client does not explicitly initialize the * <p>In case the client does not explicitly initialize the
......
...@@ -208,7 +208,7 @@ public class KeyStore ...@@ -208,7 +208,7 @@ public class KeyStore
/** /**
* Returns the default KeyStore type. This method looks up the * 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" . * property "keystore.type" or if that fails then "jks" .
*/ */
public static final String getDefaultType() public static final String getDefaultType()
......
/* Security.java --- Java base security class implementation /* 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. This file is part of GNU Classpath.
...@@ -59,7 +59,7 @@ import java.util.Vector; ...@@ -59,7 +59,7 @@ import java.util.Vector;
* *
* @author Mark Benvenuto <ivymccough@worldnet.att.net> * @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."; private static final String ALG_ALIAS = "Alg.Alias.";
...@@ -670,7 +670,7 @@ public final class Security extends Object ...@@ -670,7 +670,7 @@ public final class Security extends Object
outer: for (int r = 0; r < 3; r++) // guard against circularity outer: for (int r = 0; r < 3; r++) // guard against circularity
{ {
serviceDotAlgorithm = (svc+"."+String.valueOf(algo)).trim(); 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(); key = (String) it.next();
if (key.equalsIgnoreCase(serviceDotAlgorithm)) // eureka if (key.equalsIgnoreCase(serviceDotAlgorithm)) // eureka
......
...@@ -83,20 +83,20 @@ import gnu.java.security.Engine; ...@@ -83,20 +83,20 @@ import gnu.java.security.Engine;
* either signing data or verifying a signature:</p> * either signing data or verifying a signature:</p>
* *
* <ol> * <ol>
* <li>Initialization, with either * <li>Initialization, with either
* <ul> * <ul>
* <li>a public key, which initializes the signature for verification * <li>a public key, which initializes the signature for verification
* (see <code>initVerify()</code>), or</li> * (see <code>initVerify()</code>), or</li>
* <li>a private key (and optionally a Secure Random Number Generator), * <li>a private key (and optionally a Secure Random Number Generator),
* which initializes the signature for signing (see * which initializes the signature for signing (see
* {@link #initSign(PrivateKey)} and {@link #initSign(PrivateKey, SecureRandom)} * {@link #initSign(PrivateKey)} and {@link #initSign(PrivateKey, SecureRandom)}
* ).</li> * ).</li>
* </ul></li> * </ul></li>
* <li>Updating<br/> * <li>Updating<br/>
* Depending on the type of initialization, this will update the bytes to * Depending on the type of initialization, this will update the bytes to
* be signed or verified. See the update methods.<br/></li> * be signed or verified. See the update methods.<br/></li>
* <li>Signing or Verifying a signature on all updated bytes. See the * <li>Signing or Verifying a signature on all updated bytes. See the
* <code>sign()</code> methods and the <code>verify()</code> method.</li> * <code>sign()</code> methods and the <code>verify()</code> method.</li>
* </ol> * </ol>
* *
* <p>Note that this class is abstract and extends from {@link SignatureSpi} for * <p>Note that this class is abstract and extends from {@link SignatureSpi} for
...@@ -105,7 +105,7 @@ import gnu.java.security.Engine; ...@@ -105,7 +105,7 @@ import gnu.java.security.Engine;
* superclass are intended for cryptographic service providers who wish to * superclass are intended for cryptographic service providers who wish to
* supply their own implementations of digital signature algorithms. * 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 public abstract class Signature extends SignatureSpi
{ {
......
...@@ -279,7 +279,7 @@ public abstract class SignatureSpi ...@@ -279,7 +279,7 @@ public abstract class SignatureSpi
* @param param the string name of the parameter. * @param param the string name of the parameter.
* @return the object that represents the parameter value, or <code>null</code> * @return the object that represents the parameter value, or <code>null</code>
* if there is none. * 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 * parameter for this engine, or another exception occurs while trying to get
* this parameter. * this parameter.
* @deprecated * @deprecated
......
...@@ -98,7 +98,7 @@ import java.io.Serializable; ...@@ -98,7 +98,7 @@ import java.io.Serializable;
* <p>The signature algorithm can be, among others, the NIST standard <i>DSS</i>, * <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 * 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 * 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 * <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 * 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, * algorithm, so the signing algorithm could be specified as, for example,
......
/* DSAParameterSpec.java --- DSA Parameter Specificaton class /* 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. This file is part of GNU Classpath.
...@@ -48,7 +48,7 @@ import java.math.BigInteger; ...@@ -48,7 +48,7 @@ import java.math.BigInteger;
@author Mark Benvenuto @author Mark Benvenuto
*/ */
public class DSAParameterSpec extends Object implements AlgorithmParameterSpec, DSAParams public class DSAParameterSpec implements AlgorithmParameterSpec, DSAParams
{ {
private BigInteger p = null; private BigInteger p = null;
private BigInteger q = null; private BigInteger q = null;
......
/* DSAPrivateKeySpec.java --- DSA Private Key Specificaton class /* 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. This file is part of GNU Classpath.
...@@ -47,7 +47,7 @@ import java.math.BigInteger; ...@@ -47,7 +47,7 @@ import java.math.BigInteger;
@author Mark Benvenuto @author Mark Benvenuto
*/ */
public class DSAPrivateKeySpec extends Object implements KeySpec public class DSAPrivateKeySpec implements KeySpec
{ {
private BigInteger x = null; private BigInteger x = null;
private BigInteger p = null; private BigInteger p = null;
......
/* DSAPublicKeySpec.java --- DSA Public Key Specificaton class /* 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. This file is part of GNU Classpath.
...@@ -47,7 +47,7 @@ import java.math.BigInteger; ...@@ -47,7 +47,7 @@ import java.math.BigInteger;
@author Mark Benvenuto @author Mark Benvenuto
*/ */
public class DSAPublicKeySpec extends Object implements KeySpec public class DSAPublicKeySpec implements KeySpec
{ {
private BigInteger y = null; private BigInteger y = null;
private BigInteger p = null; private BigInteger p = null;
......
...@@ -165,13 +165,13 @@ public interface Array ...@@ -165,13 +165,13 @@ public interface Array
/** /**
* This method returns a portion of the array as a <code>ResultSet</code>. * This method returns a portion of the array as a <code>ResultSet</code>.
* The returned portion will start at <code>index</code> into the * The returned portion will start at <code>index</code> into the
* array and up to <cod>count</code> elements will be returned. * 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 * <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 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> * the actual value of that array element. The specified <code>Map</code>
* will be used to override selected default mappings of SQL types to * 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 offset The index into the array to start returning elements from.
* @param length The requested number of elements to return. * @param length The requested number of elements to return.
......
...@@ -48,14 +48,14 @@ import java.util.Map; ...@@ -48,14 +48,14 @@ import java.util.Map;
/** /**
* This interface provides access to the data set returned by a SQL * This interface provides access to the data set returned by a SQL
* statement. An instance of this interface is returned by the various * statement. An instance of this interface is returned by the various
* execution methods in the <code>Statement</code. * execution methods in the <code>Statement</code>.
* <p> *
* This class models a cursor, which can be stepped through one row at a * <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 * time. Methods are provided for accessing columns by column name or by
* index. * index.</p>
* <p> *
* Note that a result set is invalidated if the statement that returned * <p> Note that a result set is invalidated if the statement that returned
* it is closed. * it is closed.</p>
* *
* @author Aaron M. Renn (arenn@urbanophile.com) * @author Aaron M. Renn (arenn@urbanophile.com)
*/ */
......
...@@ -45,7 +45,7 @@ import java.util.Vector; ...@@ -45,7 +45,7 @@ import java.util.Vector;
* To use this class, first specify two lists of formats and range terminators. * 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 * 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>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 * included in any range, then either the first or last format will be
* used depending on whether the value X falls outside the range. * used depending on whether the value X falls outside the range.
* <p> * <p>
...@@ -196,10 +196,10 @@ public class ChoiceFormat extends NumberFormat ...@@ -196,10 +196,10 @@ public class ChoiceFormat extends NumberFormat
* This method tests this object for equality with the specified * This method tests this object for equality with the specified
* object. This will be true if and only if: * object. This will be true if and only if:
* <ul> * <ul>
* <li>The specified object is not <code>null</code>. * <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>ChoiceFormat</code>. * <li>The specified object is an instance of <code>ChoiceFormat</code>.</li>
* <li>The termination ranges and format strings are identical to * <li>The termination ranges and format strings are identical to
* this object's. * this object's. </li>
* </ul> * </ul>
* *
* @param obj The object to test for equality against. * @param obj The object to test for equality against.
......
...@@ -129,7 +129,7 @@ public final class CollationElementIterator ...@@ -129,7 +129,7 @@ public final class CollationElementIterator
/** /**
* This method resets the internal position pointer to read from the * 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() public void reset()
{ {
......
...@@ -140,12 +140,12 @@ public final class CollationKey implements Comparable ...@@ -140,12 +140,12 @@ public final class CollationKey implements Comparable
* this object. This will be true if and only if: * this object. This will be true if and only if:
* <p> * <p>
* <ul> * <ul>
* <li>The specified object must not be <code>null</code> * <li>The specified object must not be <code>null</code></li>
* <li>The specified object is an instance of <code>CollationKey</code>. * <li>The specified object is an instance of <code>CollationKey</code>.</li>
* <li>The specified object was created from the same <code>Collator</code> * <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 * <li>The specified object has the same source string and bit key as
* this object. * this object.</li>
* </ul> * </ul>
* *
* @param obj The <code>Object</code> to test for equality. * @param obj The <code>Object</code> to test for equality.
......
...@@ -183,10 +183,10 @@ public abstract class Collator implements Comparator, Cloneable ...@@ -183,10 +183,10 @@ public abstract class Collator implements Comparator, Cloneable
* object. This will be true if and only if the following conditions are * object. This will be true if and only if the following conditions are
* met: * met:
* <ul> * <ul>
* <li>The specified object is not <code>null</code>. * <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>Collator</code>. * <li>The specified object is an instance of <code>Collator</code>.</li>
* <li>The specified object has the same strength and decomposition * <li>The specified object has the same strength and decomposition
* settings as this object. * settings as this object.</li>
* </ul> * </ul>
* *
* @param obj The <code>Object</code> to test for equality against * @param obj The <code>Object</code> to test for equality against
......
...@@ -196,9 +196,9 @@ public abstract class DateFormat extends Format implements Cloneable ...@@ -196,9 +196,9 @@ public abstract class DateFormat extends Format implements Cloneable
* object: * object:
* <P> * <P>
* <ul> * <ul>
* <li>Is not <code>null</code>. * <li>Is not <code>null</code>.</li>
* <li>Is an instance of <code>DateFormat</code>. * <li>Is an instance of <code>DateFormat</code>.</li>
* <li>Has the same numberFormat field value as this object. * <li>Has the same numberFormat field value as this object.</li>
* </ul> * </ul>
* *
* @param obj The object to test for equality against. * @param obj The object to test for equality against.
......
...@@ -245,11 +245,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable ...@@ -245,11 +245,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* the array contains five values: * the array contains five values:
* <P> * <P>
* <ul> * <ul>
* <li>0 - The non-localized time zone id string. * <li>0 - The non-localized time zone id string.</li>
* <li>1 - The long name of the time zone (standard time). * <li>1 - The long name of the time zone (standard time).</li>
* <li>2 - The short name of the time zone (standard time). * <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>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>4 - the short name of the time zone (daylight savings time).</li>
* </ul>
* *
* @return The list of time zone display strings. * @return The list of time zone display strings.
*/ */
...@@ -386,11 +387,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable ...@@ -386,11 +387,12 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* the array contains five values: * the array contains five values:
* <P> * <P>
* <ul> * <ul>
* <li>0 - The non-localized time zone id string. * <li>0 - The non-localized time zone id string.</li>
* <li>1 - The long name of the time zone (standard time). * <li>1 - The long name of the time zone (standard time).</li>
* <li>2 - The short name of the time zone (standard time). * <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>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>4 - the short name of the time zone (daylight savings time).</li>
* </ul>
* *
* @return The list of time zone display strings. * @return The list of time zone display strings.
*/ */
...@@ -438,15 +440,15 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable ...@@ -438,15 +440,15 @@ public class DateFormatSymbols implements java.io.Serializable, Cloneable
* This will be true if and only if the specified object: * This will be true if and only if the specified object:
* <p> * <p>
* <ul> * <ul>
* <li> Is not <code>null</code>. * <li> Is not <code>null</code>.</li>
* <li> Is an instance of <code>DateFormatSymbols</code>. * <li> Is an instance of <code>DateFormatSymbols</code>.</li>
* <li> Contains identical formatting symbols to this object. * <li> Contains identical formatting symbols to this object.</li>
* </ul> * </ul>
* *
* @param obj The <code>Object</code> to test for equality against. * @param obj The <code>Object</code> to test for equality against.
* *
* @return <code>true</code> if the specified object is equal to this one, * @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) public boolean equals (Object obj)
{ {
......
...@@ -167,9 +167,9 @@ public final class DecimalFormatSymbols implements Cloneable, Serializable ...@@ -167,9 +167,9 @@ public final class DecimalFormatSymbols implements Cloneable, Serializable
* regard to the specified object: * regard to the specified object:
* <p> * <p>
* <ul> * <ul>
* <li>It is not <code>null</code>. * <li>It is not <code>null</code>.</li>
* <li>It is an instance of <code>DecimalFormatSymbols</code> * <li>It is an instance of <code>DecimalFormatSymbols</code>.</li>
* <li>All of its symbols are identical to the symbols in this object. * <li>All of its symbols are identical to the symbols in this object.</li>
* </ul> * </ul>
* *
* @return <code>true</code> if the specified object is equal to this * @return <code>true</code> if the specified object is equal to this
......
...@@ -123,7 +123,7 @@ public abstract class Format implements Serializable, Cloneable ...@@ -123,7 +123,7 @@ public abstract class Format implements Serializable, Cloneable
* This method parses a <code>String</code> and converts the parsed * This method parses a <code>String</code> and converts the parsed
* contents into an <code>Object</code>. * 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>. * @return The resulting <code>Object</code>.
* *
......
...@@ -116,10 +116,10 @@ public class ParsePosition ...@@ -116,10 +116,10 @@ public class ParsePosition
* all of the following conditions are met. * all of the following conditions are met.
* <p> * <p>
* <ul> * <ul>
* <li>The specified object is not <code>null</code>. * <li>The specified object is not <code>null</code>.</li>
* <li>The specified object is an instance of <code>ParsePosition</code>. * <li>The specified object is an instance of <code>ParsePosition</code>.</li>
* <li>The specified object has the same index and error index as * <li>The specified object has the same index and error index as
* this object. * this object.</li>
* </ul> * </ul>
* *
* @param obj The <code>Object</code> to test for equality against * @param obj The <code>Object</code> to test for equality against
......
...@@ -56,9 +56,9 @@ import java.util.Vector; ...@@ -56,9 +56,9 @@ import java.util.Vector;
* <p> * <p>
* Rules take the form of a <code>String</code> with the following syntax * Rules take the form of a <code>String</code> with the following syntax
* <ul> * <ul>
* <li> Modifier: '@' * <li> Modifier: '@'</li>
* <li> Relation: '&lt;' | ';' | ',' | '=' : <text> * <li> Relation: '&lt;' | ';' | ',' | '=' : &lt;text&gt;</li>
* <li> Reset: '&amp;' : <text> * <li> Reset: '&amp;' : &lt;text&gt;</li>
* </ul> * </ul>
* The modifier character indicates that accents sort backward as is the * The modifier character indicates that accents sort backward as is the
* case with French. The modifier applies to all rules <b>after</b> * case with French. The modifier applies to all rules <b>after</b>
...@@ -69,12 +69,12 @@ import java.util.Vector; ...@@ -69,12 +69,12 @@ import java.util.Vector;
* the following meanings: * the following meanings:
* <ul> * <ul>
* <li>'&lt;' - The text argument is greater than the prior term at the primary * <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 * <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 * <li>',' - The text argument is greater than the prior term at the tertiary
* difference level. * difference level.</li>
* <li>'=' - The text argument is equal to the prior term * <li>'=' - The text argument is equal to the prior term</li>
* </ul> * </ul>
* <p> * <p>
* As for the text argument itself, this is any sequence of Unicode * As for the text argument itself, this is any sequence of Unicode
...@@ -131,15 +131,15 @@ import java.util.Vector; ...@@ -131,15 +131,15 @@ import java.util.Vector;
* A <code>ParseException</code> will be thrown for any of the following * A <code>ParseException</code> will be thrown for any of the following
* conditions: * conditions:
* <ul> * <ul>
* <li>Unquoted punctuation characters in 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>A relational or reset operator not followed by a text argument</li>
* <li>A reset operator where the text argument is not present in * <li>A reset operator where the text argument is not present in
* the previous rule string section. * the previous rule string section.</li>
* </ul> * </ul>
* *
* @author Aaron M. Renn <arenn@urbanophile.com> * @author Aaron M. Renn (arenn@urbanophile.com)
* @author Tom Tromey <tromey@cygnus.com> * @author Tom Tromey (tromey@cygnus.com)
* @author Guilhem Lavaux <guilhem@kaffe.org> * @author Guilhem Lavaux (guilhem@kaffe.org)
*/ */
public class RuleBasedCollator extends Collator public class RuleBasedCollator extends Collator
{ {
......
...@@ -358,13 +358,13 @@ public class SimpleDateFormat extends DateFormat ...@@ -358,13 +358,13 @@ public class SimpleDateFormat extends DateFormat
* object. This will be true if and only if the specified object: * object. This will be true if and only if the specified object:
* <p> * <p>
* <ul> * <ul>
* <li>Is not <code>null</code>. * <li>Is not <code>null</code>.</li>
* <li>Is an instance of <code>SimpleDateFormat</code>. * <li>Is an instance of <code>SimpleDateFormat</code>.</li>
* <li>Is equal to this object at the superclass (i.e., <code>DateFormat</code>) * <li>Is equal to this object at the superclass (i.e., <code>DateFormat</code>)
* level. * level.</li>
* <li>Has the same formatting pattern. * <li>Has the same formatting pattern.</li>
* <li>Is using the same formatting symbols. * <li>Is using the same formatting symbols.</li>
* <li>Is using the same century for two digit years. * <li>Is using the same century for two digit years.</li>
* </ul> * </ul>
* *
* @param obj The object to compare for equality against. * @param obj The object to compare for equality against.
......
...@@ -314,10 +314,10 @@ public final class StringCharacterIterator implements CharacterIterator ...@@ -314,10 +314,10 @@ public final class StringCharacterIterator implements CharacterIterator
* object. This will be true if and only if the specified object: * object. This will be true if and only if the specified object:
* <p> * <p>
* <ul> * <ul>
* <li>is not <code>null</code>. * <li>is not <code>null</code>.</li>
* <li>is an instance of <code>StringCharacterIterator</code> * <li>is an instance of <code>StringCharacterIterator</code></li>
* <li>has the same text as this object * <li>has the same text as this object</li>
* <li>has the same beginning, ending, and current index as this object. * <li>has the same beginning, ending, and current index as this object.</li>
* </ul> * </ul>
* *
* @param obj The object to test for equality against. * @param obj The object to test for equality against.
......
...@@ -54,7 +54,7 @@ import java.io.Serializable; ...@@ -54,7 +54,7 @@ import java.io.Serializable;
* are not required, to throw the {@link UnsupportedOperationException} that * are not required, to throw the {@link UnsupportedOperationException} that
* the underlying collection would throw during an attempt at modification. * the underlying collection would throw during an attempt at modification.
* For example, * 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 * 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 * on a singleton; the reason for this is that addAll did not attempt to
* modify the set. * modify the set.
......
...@@ -54,7 +54,7 @@ import java.io.InputStream; ...@@ -54,7 +54,7 @@ import java.io.InputStream;
* *
* If there is also a class for this resource and the same locale, the * 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 * 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 * extension <code>.properties</code>. The file should have the same format
* as for <code>Properties.load()</code> * as for <code>Properties.load()</code>
* *
......
...@@ -51,7 +51,7 @@ import gnu.classpath.Configuration; ...@@ -51,7 +51,7 @@ import gnu.classpath.Configuration;
* <code>getObject</code> or <code>getString</code> on that bundle. * <code>getObject</code> or <code>getString</code> on that bundle.
* *
* <p>When a bundle is demanded for a specific locale, the ResourceBundle * <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 * two letter ISO language code of the default locale (see
* <code>Locale.getDefault()</code>). * <code>Locale.getDefault()</code>).
* *
...@@ -251,18 +251,22 @@ public abstract class ResourceBundle ...@@ -251,18 +251,22 @@ public abstract class ResourceBundle
* *
* <p>A sequence of candidate bundle names are generated, and tested in * <p>A sequence of candidate bundle names are generated, and tested in
* this order, where the suffix 1 means the string from the specified * 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 + "_" + variant1</li>
* <li>baseName + "_" + language1 + "_" + country1</li> * <li>baseName + "_" + language1 + "_" + country1</li>
* <li>baseName + "_" + language1</li> * <li>baseName + "_" + language1</li>
* <li>baseName + "_" + language2 + "_" + country2 + "_" + variant2</li> * <li>baseName + "_" + language2 + "_" + country2 + "_" + variant2</li>
* <li>baseName + "_" + language2 + "_" + country2</li> * <li>baseName + "_" + language2 + "_" + country2</li>
* <li>baseName + "_" + language2<li> * <li>baseName + "_" + language2</li>
* <li>baseName</li> * <li>baseName</li>
* </ul> * </ul>
* *
* <p>In the sequence, entries with an empty string are ignored. Next, * <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 * <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 * which is a subclass of ResourceBundle, and which has a public constructor
* with no arguments, via reflection.</li> * with no arguments, via reflection.</li>
...@@ -277,7 +281,7 @@ public abstract class ResourceBundle ...@@ -277,7 +281,7 @@ public abstract class ResourceBundle
* in the above sequence are tested in a similar manner, and if any results * 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 * 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 * 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 * <p>For example, suppose the following class and property files are
* provided: MyResources.class, MyResources_fr_CH.properties, * provided: MyResources.class, MyResources_fr_CH.properties,
...@@ -286,10 +290,12 @@ public abstract class ResourceBundle ...@@ -286,10 +290,12 @@ public abstract class ResourceBundle
* all files are valid (that is, public non-abstract subclasses of * all files are valid (that is, public non-abstract subclasses of
* ResourceBundle with public nullary constructors for the ".class" files, * ResourceBundle with public nullary constructors for the ".class" files,
* syntactically correct ".properties" files). The default locale is * 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 * <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 * <li>Locale("fr", "CH"): result MyResources_fr_CH.class, parent
* MyResources_fr.properties, parent MyResources.class</li> * MyResources_fr.properties, parent MyResources.class</li>
* <li>Locale("fr", "FR"): result MyResources_fr.properties, parent * <li>Locale("fr", "FR"): result MyResources_fr.properties, parent
...@@ -301,8 +307,9 @@ public abstract class ResourceBundle ...@@ -301,8 +307,9 @@ public abstract class ResourceBundle
* <li>Locale("es", "ES"): result MyResources_es_ES.class, parent * <li>Locale("es", "ES"): result MyResources_es_ES.class, parent
* MyResources.class</li> * MyResources.class</li>
* </ul> * </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 baseName the name of the ResourceBundle
* @param locale A locale * @param locale A locale
......
...@@ -196,7 +196,7 @@ public class StringTokenizer implements Enumeration ...@@ -196,7 +196,7 @@ public class StringTokenizer implements Enumeration
/** /**
* This does the same as hasMoreTokens. This is the * 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 * @return true, if the next call of nextElement() will succeed
* @see #hasMoreTokens() * @see #hasMoreTokens()
...@@ -208,7 +208,7 @@ public class StringTokenizer implements Enumeration ...@@ -208,7 +208,7 @@ public class StringTokenizer implements Enumeration
/** /**
* This does the same as nextTokens. This is the * 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 * @return the next token with respect to the current delimiter characters
* @throws NoSuchElementException if there are no more tokens * @throws NoSuchElementException if there are no more tokens
......
...@@ -85,17 +85,18 @@ public class Attributes implements Cloneable, Map ...@@ -85,17 +85,18 @@ public class Attributes implements Cloneable, Map
* attributes, applet attributes, extension identification attributes, * attributes, applet attributes, extension identification attributes,
* package versioning and sealing attributes, file contents attributes, * package versioning and sealing attributes, file contents attributes,
* bean objects attribute and signing attributes. See the * 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> * <ul>
* <li> Must contain at least one character * <li>Must contain at least one character</li>
* <li> The first character must be alphanumeric (a-z, A-Z, 0-9) * <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>All other characters must be alphanumeric, a '-' or a '_'</li>
* </ul> * </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 * 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 * @since 1.2
* @author Mark Wielaard (mark@klomp.org) * @author Mark Wielaard (mark@klomp.org)
...@@ -145,15 +146,15 @@ public class Attributes implements Cloneable, Map ...@@ -145,15 +146,15 @@ public class Attributes implements Cloneable, Map
* Manifest manifest file with the following Names: * Manifest manifest file with the following Names:
* <ul> * <ul>
* <li> &lt;extension&gt;-Extension-Name: * <li> &lt;extension&gt;-Extension-Name:
* unique name of the extension * unique name of the extension</li>
* <li> &lt;extension&gt;-Specification-Version: * <li> &lt;extension&gt;-Specification-Version:
* minimum specification version * minimum specification version</li>
* <li> &lt;extension&gt;-Implementation-Version: * <li> &lt;extension&gt;-Implementation-Version:
* minimum implementation version * minimum implementation version</li>
* <li> &lt;extension&gt;-Implementation-Vendor-Id: * <li> &lt;extension&gt;-Implementation-Vendor-Id:
* unique id of implementation vendor * unique id of implementation vendor</li>
* <li> &lt;extension&gt;-Implementation-URL: * <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> * </ul>
*/ */
public static final Name EXTENSION_LIST = new Name("Extension-List"); public static final Name EXTENSION_LIST = new Name("Extension-List");
......
...@@ -67,7 +67,7 @@ package java.util.logging; ...@@ -67,7 +67,7 @@ package java.util.logging;
* *
* <li><code>java.util.logging.ConsoleHandler.encoding</code> - specifies * <li><code>java.util.logging.ConsoleHandler.encoding</code> - specifies
* the name of the character encoding. Default value: * the name of the character encoding. Default value:
* the default platform encoding. * the default platform encoding.</li>
* *
* </ul> * </ul>
* *
......
...@@ -67,13 +67,12 @@ import java.lang.ref.WeakReference; ...@@ -67,13 +67,12 @@ import java.lang.ref.WeakReference;
* <code>java.util.logging.LogManager</code> is initialized. * <code>java.util.logging.LogManager</code> is initialized.
* The configuration process includes the subsequent steps: * The configuration process includes the subsequent steps:
* *
* <ol> * <ul>
* <li>If the system property <code>java.util.logging.manager</code> * <li>If the system property <code>java.util.logging.manager</code>
* is set to the name of a subclass of * is set to the name of a subclass of
* <code>java.util.logging.LogManager</code>, an instance of * <code>java.util.logging.LogManager</code>, an instance of
* that subclass is created and becomes the global LogManager. * that subclass is created and becomes the global LogManager.
* Otherwise, a new instance of LogManager is created.</li> * Otherwise, a new instance of LogManager is created.</li>
*
* <li>The <code>LogManager</code> constructor tries to create * <li>The <code>LogManager</code> constructor tries to create
* a new instance of the class specified by the system * a new instance of the class specified by the system
* property <code>java.util.logging.config.class</code>. * property <code>java.util.logging.config.class</code>.
...@@ -91,14 +90,13 @@ import java.lang.ref.WeakReference; ...@@ -91,14 +90,13 @@ import java.lang.ref.WeakReference;
* {@link #readConfiguration(java.io.InputStream)}. * {@link #readConfiguration(java.io.InputStream)}.
* The name and location of this file are specified by the system * The name and location of this file are specified by the system
* property <code>java.util.logging.config.file</code>.</li> * property <code>java.util.logging.config.file</code>.</li>
*
* <li>If the system property <code>java.util.logging.config.file</code> * <li>If the system property <code>java.util.logging.config.file</code>
* is not set, however, the contents of the URL * is not set, however, the contents of the URL
* "{gnu.classpath.home.url}/logging.properties" are passed to * "{gnu.classpath.home.url}/logging.properties" are passed to
* {@link #readConfiguration(java.io.InputStream)}. * {@link #readConfiguration(java.io.InputStream)}.
* Here, "{gnu.classpath.home.url}" stands for the value of * Here, "{gnu.classpath.home.url}" stands for the value of
* the system property <code>gnu.classpath.home.url</code>.</li> * the system property <code>gnu.classpath.home.url</code>.</li>
* </ol> * </ul>
* *
* @author Sascha Brawer (brawer@acm.org) * @author Sascha Brawer (brawer@acm.org)
*/ */
...@@ -259,10 +257,10 @@ public class LogManager ...@@ -259,10 +257,10 @@ public class LogManager
* *
* @param logger the logger to be added. * @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. * <code>false</code> otherwise.
* *
* @throws NullPointerException if <code>name<code> is * @throws NullPointerException if <code>name</code> is
* <code>null</code>. * <code>null</code>.
*/ */
public synchronized boolean addLogger(Logger logger) public synchronized boolean addLogger(Logger logger)
......
...@@ -35,10 +35,7 @@ module. An independent module is a module which is not derived from ...@@ -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 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 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 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; package java.util.logging;
...@@ -53,28 +50,22 @@ package java.util.logging; ...@@ -53,28 +50,22 @@ package java.util.logging;
* value, a default is taken without an exception being thrown. * value, a default is taken without an exception being thrown.
* *
* <ul> * <ul>
*
* <li><code>java.util.MemoryHandler.level</code> - specifies * <li><code>java.util.MemoryHandler.level</code> - specifies
* the initial severity level threshold. Default value: * the initial severity level threshold. Default value:
* <code>Level.ALL</code>.</li> * <code>Level.ALL</code>.</li>
*
* <li><code>java.util.MemoryHandler.filter</code> - specifies * <li><code>java.util.MemoryHandler.filter</code> - specifies
* the name of a Filter class. Default value: No Filter.</li> * the name of a Filter class. Default value: No Filter.</li>
*
* <li><code>java.util.MemoryHandler.size</code> - specifies the * <li><code>java.util.MemoryHandler.size</code> - specifies the
* maximum number of log records that are kept in the circular * maximum number of log records that are kept in the circular
* buffer. Default value: 1000.</li> * buffer. Default value: 1000.</li>
*
* <li><code>java.util.MemoryHandler.push</code> - specifies the * <li><code>java.util.MemoryHandler.push</code> - specifies the
* <code>pushLevel</code>. Default value: * <code>pushLevel</code>. Default value:
* <code>Level.SEVERE</code>.</li> * <code>Level.SEVERE</code>.</li>
*
* <li><code>java.util.MemoryHandler.target</code> - specifies the * <li><code>java.util.MemoryHandler.target</code> - specifies the
* name of a subclass of {@link Handler} that will be used as the * name of a subclass of {@link Handler} that will be used as the
* target handler. There is no default value for this property; * target handler. There is no default value for this property;
* if it is not set, the no-argument MemoryHandler constructor * if it is not set, the no-argument MemoryHandler constructor
* will throw an exception.</li> * will throw an exception.</li>
*
* </ul> * </ul>
* *
* @author Sascha Brawer (brawer@acm.org) * @author Sascha Brawer (brawer@acm.org)
......
...@@ -68,7 +68,7 @@ package java.util.logging; ...@@ -68,7 +68,7 @@ package java.util.logging;
* *
* <li><code>java.util.SocketHandler.encoding</code> - specifies * <li><code>java.util.SocketHandler.encoding</code> - specifies
* the name of the character encoding. Default value: * 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 * <li><code>java.util.SocketHandler.host</code> - specifies
* the name of the host to which records are published. * the name of the host to which records are published.
......
...@@ -93,7 +93,7 @@ public class NamingException extends Exception ...@@ -93,7 +93,7 @@ public class NamingException extends Exception
/** /**
* Creates a new NamingException without a message. Does not set any of the * Creates a new NamingException without a message. Does not set any of the
* <code>rootException</code>, <code>resolvedName</code>, * <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. * These fields can be set later.
*/ */
public NamingException () public NamingException ()
...@@ -104,7 +104,7 @@ public class NamingException extends Exception ...@@ -104,7 +104,7 @@ public class NamingException extends Exception
/** /**
* Creates a new NamingException with a detailed message. Does not set * Creates a new NamingException with a detailed message. Does not set
* the <code>rootException</code>, <code>resolvedName</code>, * 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. * These fields can be set later.
*/ */
public NamingException (String msg) public NamingException (String msg)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment