Index: modules/security/src/common/javasrc/java/security/cert/CRL.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CRL.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CRL.java 2006-03-30 08:31:52.000000000 +0100 @@ -21,9 +21,12 @@ package java.security.cert; + /** - * @com.intel.drl.spec_ref + * This class represents Certificate Revocation Lists (CRLs). They are used to + * indicate that a given Certificate has expired already. * + * @see CertificateFactory */ public abstract class CRL { // The CRL type @@ -36,20 +39,31 @@ this.type = type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers the type of this CRL. + * + * @return String the type of this CRL. + */ public final String getType() { return type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers if a given Certificate has been revoked or not. + * + * @param cert + * Certificate The Certificate to test + * + * @return true if the certificate has been revoked false if the certificate + * has not been revoked yet + */ public abstract boolean isRevoked(Certificate cert); - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers a string containing a concise, human-readable description of the + * receiver. + * + * @return a printable representation for the receiver. + */ public abstract String toString(); } Index: modules/security/src/common/javasrc/java/security/cert/CRLException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CRLException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CRLException.java 2006-03-30 08:31:52.000000000 +0100 @@ -34,16 +34,20 @@ */ private static final long serialVersionUID = -6694728944094197147L; - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CRLException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CRLException() { } Index: modules/security/src/common/javasrc/java/security/cert/CertPath.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertPath.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertPath.java 2006-03-30 08:31:52.000000000 +0100 @@ -30,8 +30,17 @@ import java.util.List; /** - * @com.intel.drl.spec_ref + * An immutable certificate path that can be validated. All certificates in the + * path are of the same type (i.e., X509). * + * A CertPath can be represented as a byte array in at least one + * supported encoding when serialized. + * + * When a List of the certificates is obtained it must be + * immutable. + * + * A CertPath must be thread-safe without requiring coordinated + * access. */ public abstract class CertPath implements Serializable { /** @@ -48,16 +57,24 @@ this.type = type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns the type of Certificate in the + * CertPath + * + * @return Certificate type + */ public String getType() { return type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns true if Certificates in the list are the same + * type and the lists are equal (and by implication the certificates + * contained within are the same). + * + * @param other + * CertPath to be compared for equality + */ public boolean equals(Object other) { if (this == other) { return true; @@ -73,18 +90,27 @@ return false; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Overrides Object.hashCode() Defined as: hashCode = 31 * + * path.getType().hashCode() + path.getCertificates().hashCode(); + * + * @return hash code for CertPath object + */ public int hashCode() { int hash = getType().hashCode(); hash = hash*31 + getCertificates().hashCode(); return hash; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns a String representation of the + * CertPath + * Certificates. It is the result of + * calling toString on all Certificates in + * the List. Certificates + * + * @return string representation of CertPath + */ public String toString() { StringBuffer sb = new StringBuffer(getType()); sb.append(" Cert Path, len="); @@ -102,26 +128,43 @@ return sb.toString(); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns an immutable List of the Certificates contained + * in the CertPath. + * + * @return list of Certificates in the CertPath + */ public abstract List getCertificates(); - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns an encoding of the CertPath using the default + * encoding + * + * @return default encoding of the CertPath + * @throws CertificateEncodingException + */ public abstract byte[] getEncoded() throws CertificateEncodingException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns an encoding of the CertPath using the specified + * encoding + * + * @param encoding + * encoding that should be generated + * @return default encoding of the CertPath + * @throws CertificateEncodingException + */ public abstract byte[] getEncoded(String encoding) throws CertificateEncodingException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Return an Iterator over the supported encodings for a + * representation of the certificate path. + * + * @return Iterator over supported encodings (as + * Strings) + */ public abstract Iterator getEncodings(); /** Index: modules/security/src/common/javasrc/java/security/cert/Certificate.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/Certificate.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/Certificate.java 2006-03-30 08:31:52.000000000 +0100 @@ -34,8 +34,9 @@ import java.util.Arrays; /** - * @com.intel.drl.spec_ref - * + * Abstract class to represent identity certificates. It represents a way to + * verify the binding of a Principal and its public key. Examples are X.509, + * PGP, and SDSI. */ public abstract class Certificate implements Serializable { /** @@ -53,16 +54,27 @@ this.type = type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers the certificate type represented by the receiver. + * + * @return the certificate type represented by the receiver. + */ public final String getType() { return type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Compares the argument to the receiver, and answers true if they represent + * the same object using a class specific comparison. The + * implementation in Object answers true only if the argument is the exact + * same object as the receiver (==). + * + * @param other + * the object to compare with this object + * @return true if the object is the same as this object + * false if it is different from this object + * @see #hashCode + */ public boolean equals(Object other) { // obj equal to itself if (this == other) { @@ -80,9 +92,15 @@ return false; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers an integer hash code for the receiver. Any two objects which + * answer true when passed to equals must + * answer the same value for this method. + * + * @return the receiver's hash + * + * @see #equals + */ public int hashCode() { try { byte[] encoded = getEncoded(); @@ -96,14 +114,31 @@ } } - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers the encoded representation for this certificate. + * + * @return the encoded representation for this certificate. + */ public abstract byte[] getEncoded() throws CertificateEncodingException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Verifies that this certificate was signed with the given public key. + * + * @param key + * PublicKey public key for which verification should be + * performed. + * + * @exception CertificateException + * if encoding errors are detected + * @exception NoSuchAlgorithmException + * if an unsupported algorithm is detected + * @exception InvalidKeyException + * if an invalid key is detected + * @exception NoSuchProviderException + * if there is no default provider + * @exception SignatureException + * if signature errors are detected + */ public abstract void verify(PublicKey key) throws CertificateException, NoSuchAlgorithmException, @@ -111,9 +146,27 @@ NoSuchProviderException, SignatureException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Verifies that this certificate was signed with the given public key. Uses + * the signature algorithm given by the provider. + * + * @param key + * PublicKey public key for which verification should be + * performed. + * @param sigProvider + * String the name of the signature provider. + * + * @exception CertificateException + * if encoding errors are detected + * @exception NoSuchAlgorithmException + * if an unsupported algorithm is detected + * @exception InvalidKeyException + * if an invalid key is detected + * @exception NoSuchProviderException + * if there is no default provider + * @exception SignatureException + * if signature errors are detected + */ public abstract void verify(PublicKey key, String sigProvider) throws CertificateException, NoSuchAlgorithmException, @@ -121,14 +174,19 @@ NoSuchProviderException, SignatureException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers a string containing a concise, human-readable description of the + * receiver. + * + * @return a printable representation for the receiver. + */ public abstract String toString(); - /** - * @com.intel.drl.spec_ref - */ + /** + * Answers the public key corresponding to this certificate. + * + * @return the public key corresponding to this certificate. + */ public abstract PublicKey getPublicKey(); /** Index: modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java 2006-03-30 08:31:52.000000000 +0100 @@ -21,9 +21,9 @@ package java.security.cert; + /** - * @com.intel.drl.spec_ref - * + * This class represents an encoding exception for a certificate. */ public class CertificateEncodingException extends CertificateException { /** @@ -31,18 +31,20 @@ */ private static final long serialVersionUID = 6219492851589449162L; - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CertificateEncodingException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CertificateEncodingException() { } Index: modules/security/src/common/javasrc/java/security/cert/CertificateException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateException.java 2006-03-30 08:31:52.000000000 +0100 @@ -24,8 +24,7 @@ import java.security.GeneralSecurityException; /** - * @com.intel.drl.spec_ref - * + * This class represents a general certificate exception. */ public class CertificateException extends GeneralSecurityException { @@ -35,18 +34,20 @@ */ private static final long serialVersionUID = 3192535253797119798L; - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CertificateException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CertificateException() { } Index: modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java 2006-03-30 08:31:52.000000000 +0100 @@ -21,9 +21,9 @@ package java.security.cert; + /** - * @com.intel.drl.spec_ref - * + * This class indicates that a given certificate has expired. */ public class CertificateExpiredException extends CertificateException { @@ -33,18 +33,20 @@ */ private static final long serialVersionUID = 9071001339691533771L; - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CertificateExpiredException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - * - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CertificateExpiredException() { } } \ No newline at end of file Index: modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java 2006-03-30 08:31:52.000000000 +0100 @@ -32,12 +32,9 @@ import org.apache.harmony.security.fortress.Engine; - /** - * @com.intel.drl.spec_ref - * + * This class provides the functionality of a certificate factory algorithm. */ - public class CertificateFactory { // Store CertificateFactory service name @@ -66,14 +63,17 @@ this.spiImpl = certFacSpi; } - /** - * @com.intel.drl.spec_ref - * - * throws CertificateException using NoSuchAlgorithmException information - * - * throws NullPointerException if algorithm is null (instead of - * CertificateException as in 1.4 release) - */ + /** + * Answers a new CertificateFactory of the given type. + * + * @param type + * java.lang.String Type of certificate desired + * @return CertificateFactory a concrete implementation for the certificate + * type desired. + * + * @exception CertificateException + * If the type cannot be found + */ public static final CertificateFactory getInstance(String type) throws CertificateException { if (type == null) { @@ -109,14 +109,20 @@ return getInstance(type, impProvider); } - /** - * @com.intel.drl.spec_ref - * - * throws CertificateException using NoSuchAlgorithmException information - * - * throws NullPointerException if algorithm is null (instead of - * CertificateException as in 1.4 release) - */ + /** + * Answers a new CertificateFactory of the given type. + * + * @param type + * java.lang.String Type of certificatem desired + * @param provider + * java.security.Provider Provider which has to implement the + * algorithm + * @return CertificateFactory a concrete implementation for the certificate + * type desired. + * + * @exception CertificateException + * If the type cannot be found + */ public static final CertificateFactory getInstance(String type, Provider provider) throws CertificateException { if (provider == null) { @@ -136,40 +142,66 @@ } } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns the Provider of the certificate factory represented by the + * receiver. + * + * @return Provider an instance of a subclass of java.security.Provider + */ public final Provider getProvider() { return provider; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Returns the Certificate type + * + * @return String type of certificate being used + */ public final String getType() { return type; } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates and initializes a Certificate from data from the provided input + * stream. + * + * @param inStream + * InputStream Stream from where data is read to create the + * Certificate + * + * @return Certificate an initialized Certificate + * @exception CertificateException + * if parsing problems are detected + */ public final Certificate generateCertificate(InputStream inStream) throws CertificateException { return spiImpl.engineGenerateCertificate(inStream); } - /** - * @com.intel.drl.spec_ref - * - * FIXME: update to Iterator getCertPathEncodings() - */ + /** + * Returns an Iterator over the supported CertPath encodings (as Strings). + * The first element is the default encoding. + * + * @return Iterator Iterator over supported CertPath encodings (as Strings) + * + * FIXME: update to Iterator getCertPathEncodings() + */ public final Iterator getCertPathEncodings() { return spiImpl.engineGetCertPathEncodings(); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates a CertPath from data from the provided + * InputStream. The default encoding is assumed. + * + * @param inStream + * InputStream with PKCS7 or PkiPath encoded data + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + */ public final CertPath generateCertPath(InputStream inStream) throws CertificateException { Iterator it = getCertPathEncodings(); @@ -179,48 +211,101 @@ return spiImpl.engineGenerateCertPath(inStream, (String) it.next()); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates a CertPath from data from the provided + * InputStream. The encoding is that specified by the + * encoding parameter. + * + * @param inStream + * InputStream containing certificate path data in specified + * encoding + * @param encoding + * encoding of the data in the input stream + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + * @throws UnsupportedOperationException + * if the provider does not implement this method + */ public final CertPath generateCertPath(InputStream inStream, String encoding) throws CertificateException { return spiImpl.engineGenerateCertPath(inStream, encoding); } - /** - * @com.intel.drl.spec_ref - * - * FIXME: update parameter to (List certificates) - */ + /** + * Generates a CertPath from the provided List of + * Certificates. The encoding is the default encoding. + * + * @param certificates + * List containing certificates in a format supported by the + * CertificateFactory + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + * @throws UnsupportedOperationException + * if the provider does not implement this method + * + * FIXME: update parameter to (List certificates) + */ public final CertPath generateCertPath(List certificates) throws CertificateException { return spiImpl.engineGenerateCertPath(certificates); } - /** - * @com.intel.drl.spec_ref - * - * FIXME: update returned value to Collection - */ + /** + * Generates and initializes a collection of Certificates from data from the + * provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the + * Certificates + * + * @return Collection an initialized collection of Certificates + * @exception CertificateException + * if parsing problems are detected + * + * FIXME: update returned value to Collection + */ public final Collection generateCertificates(InputStream inStream) throws CertificateException { return spiImpl.engineGenerateCertificates(inStream); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates and initializes a Certificate Revocation List from data from + * the provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the CRL + * + * @return CRL an initialized Certificate Revocation List + * @exception CRLException + * if parsing problems are detected + */ public final CRL generateCRL(InputStream inStream) throws CRLException { return spiImpl.engineGenerateCRL(inStream); } - /** - * @com.intel.drl.spec_ref - * - * FIXME: update returned value to Collection - */ + /** + * Generates and initializes a collection of Certificate Revocation List + * from data from the provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the CRLs + * + * @return Collection an initialized collection of Certificate Revocation + * List + * @exception CRLException + * if parsing problems are detected + * + * FIXME: update returned value to Collection + */ public final Collection generateCRLs(InputStream inStream) throws CRLException { return spiImpl.engineGenerateCRLs(inStream); } -} \ No newline at end of file +} Index: modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java 2006-03-30 08:31:52.000000000 +0100 @@ -27,80 +27,152 @@ import java.util.List; /** - * @com.intel.drl.spec_ref - * + * This class is a Service Provider Interface (therefore the Spi suffix) for + * certificate factories to be supplied by providers. */ - public abstract class CertificateFactorySpi { - - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class. + */ public CertificateFactorySpi() { } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates and initializes a Certificate from data from the provided input + * stream. + * + * @param inStream + * InputStream Stream from where data is read to create the + * Certificate + * + * @return Certificate an initialized Certificate + * @exception CertificateException + * if parsing problems are detected + */ public abstract Certificate engineGenerateCertificate(InputStream inStream) throws CertificateException; - /** - * @com.intel.drl.spec_ref - * - * FIXME: 1.5 updates are needed Collection - */ + /** + * Generates and initializes a collection of Certificates from data from the + * provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the + * Certificates + * + * @return Collection an initialized collection of Certificates + * @exception CertificateException + * if parsing problems are detected + * + * FIXME: 1.5 updates are needed Collection + */ public abstract Collection engineGenerateCertificates(InputStream inStream) throws CertificateException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates and initializes a Certificate Revocation List from data from + * the provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the CRL + * + * @return CRL an initialized Certificate Revocation List + * @exception CRLException + * if parsing problems are detected + */ public abstract CRL engineGenerateCRL(InputStream inStream) throws CRLException; - /** - * @com.intel.drl.spec_ref - * - * FIXME: 1.5 updates are needed Collection - */ + /** + * Generates and initializes a collection of Certificate Revocation List + * from data from the provided input stream. + * + * @param inStream + * InputStream Stream from where data is read to create the CRLs + * + * @return Collection an initialized collection of Certificate Revocation + * List + * @exception CRLException + * if parsing problems are detected + * + * FIXME: 1.5 updates are needed Collection + */ public abstract Collection engineGenerateCRLs(InputStream inStream) throws CRLException; - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates a CertPath from data from the provided + * InputStream. The default encoding is assumed. + * + * @param inStream + * InputStream with PKCS7 or PkiPath encoded data + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + */ public CertPath engineGenerateCertPath(InputStream inStream) throws CertificateException { throw new UnsupportedOperationException( "Method engineGenerateCertPath(InputStream inStream) is not supported"); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates a CertPath from data from the provided + * InputStream. The encoding is that specified by the + * encoding parameter. + * + * @param inStream + * InputStream containing certificate path data in specified + * encoding + * @param encoding + * encoding of the data in the input stream + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + * @throws UnsupportedOperationException + * if the provider does not implement this method + */ public CertPath engineGenerateCertPath(InputStream inStream, String encoding) throws CertificateException { throw new UnsupportedOperationException( "Method engineGenerateCertPath(InputStream inStream, String encoding) is not supported"); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Generates a CertPath from the provided List of + * Certificates. The encoding is the default encoding. + * + * @param certificates + * List containing certificates in a format supported by the + * CertificateFactory + * + * @return CertPath a CertPath initialized from the provided data + * + * @throws CertificateException + * if parsing problems are detected + * @throws UnsupportedOperationException + * if the provider does not implement this method + */ public CertPath engineGenerateCertPath(List certificates) throws CertificateException { throw new UnsupportedOperationException( "Method engineGenerateCertPath(List certificates) is not supported"); } - /** - * @com.intel.drl.spec_ref - * - * FIXME: 1.5 updates are needed Iterator - */ + /** + * Returns an Iterator over the supported CertPath encodings (as Strings). + * The first element is the default encoding. + * + * @return Iterator Iterator over supported CertPath encodings (as Strings) + * + * FIXME: 1.5 updates are needed Iterator + */ public Iterator engineGetCertPathEncodings() { throw new UnsupportedOperationException( "Method engineGetCertPathEncodings() is not supported"); } -} \ No newline at end of file +} Index: modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java 2006-03-30 08:31:52.000000000 +0100 @@ -21,9 +21,9 @@ package java.security.cert; + /** - * @com.intel.drl.spec_ref - * + * This class indicates that a given certificate is not valid yet. */ public class CertificateNotYetValidException extends CertificateException { /** @@ -31,16 +31,20 @@ */ private static final long serialVersionUID = 4355919900041064702L; - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CertificateNotYetValidException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CertificateNotYetValidException() { } } \ No newline at end of file Index: modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java =================================================================== --- modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java.orig 2006-03-30 08:31:04.000000000 +0100 +++ modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java 2006-03-30 08:31:52.000000000 +0100 @@ -21,9 +21,9 @@ package java.security.cert; + /** - * @com.intel.drl.spec_ref - * + * This class indicates that a given certificate could not be parsed. */ public class CertificateParsingException extends CertificateException { @@ -32,16 +32,20 @@ */ private static final long serialVersionUID = -7989222416793322029L; - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback and message + * filled in. + * + * @param msg + * String The detail message for the exception. + */ public CertificateParsingException(String msg) { super(msg); } - /** - * @com.intel.drl.spec_ref - */ + /** + * Constructs a new instance of this class with its walkback filled in. + */ public CertificateParsingException() { }