Name: ddT132432 Date: 07/25/2001


java version "1.2.2"
Solaris VM (build Solaris_JDK_1.2.2, native threads, sunwjit)

See jdk1.4/docs/api/java/security/GeneralSecurityException.html in the
standard javadoc-generated API documentation.

The doc for "Class GeneralSecurityException" lists CertificateException as one
of its subclasses. However, in the descriptive paragraph after the second
horizontal rule, it says

This is the general security exception class, which serves to group all the
exception classes of the java.security
package that extend from it. (Exceptions are AccessControlException and
>>>>CertificateException<<<<, which subclass from
java.lang.SecurityException, and ProviderException and
InvalidParameterException, which subclass from
java.lang.RuntimeException.)

CertificateException cannot be subclass of both GeneralSecurityException and
SecurityException.
(Review ID: 128798)

From incident(128807)
I'm not sure this is also an inconsistency - you be the judge. You may wish to
file this along with bug 4484169, which describes the first inconsistency I
found in this doc.

I found a second ( possible ) inconsistency. The descriptive text after the
second horizontal rule says:

This is the general security exception class, which serves to group all the
exception classes of the java.security
package that extend from it. (Exceptions are AccessControlException and
CertificateException, which subclass from
java.lang.SecurityException, and ProviderException and
>>>>InvalidParameterException<<<<, which subclass from
java.lang.RuntimeException.)

InvalidParameterException subclasses from IllegalArgumentException, which itself
subclasses from RuntimeException. So, InvalidParameterException is a grandchild
or "sub-sub-class" of RuntimeException. Is this a bug, or is the text correct
in saying that the former "subclasses" from the latter?
======================================================================