Review request for 6857803 Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces} (original) (raw)
Joe Darcy Joe.Darcy at Sun.COM
Tue Jul 7 04:57:54 UTC 2009
- Previous message: Patching serviceloader
- Next message: Review request for 6857803 Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces}
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Hello.
Below is a simple patch for JDK 7 to fix a minor javadoc problem in java.lang.Clas. The javadoc for methods getGenericSuperclass and getGenericInterfaces make @throws reference to two exceptions in the java.lang.reflect package; these exceptions don't get rendered as links in the HTML output because they are in a different package. The fix is to add the package qualification; importing the exceptions would have worked too, but the imports are not needed by the code in java.lang.Class.
Thanks,
-Joe
--- old/src/share/classes/java/lang/Class.java 2009-07-06 21:31:15.000000000 -0700 +++ new/src/share/classes/java/lang/Class.java 2009-07-06 21:31:15.000000000 -0700 @@ -673,12 +673,12 @@ * {@code Class} object representing the {@code Object} class is * returned. *
* @throws GenericSignatureFormatError if the generic
* @throws java.lang.reflect.GenericSignatureFormatError if the
generic * class signature does not conform to the format specified in the * Java Virtual Machine Specification, 3rd edition * @throws TypeNotPresentException if the generic superclass * refers to a non-existent type declaration
* @throws MalformedParameterizedTypeException if the
* @throws java.lang.reflect.MalformedParameterizedTypeException if
the * generic superclass refers to a parameterized type that cannot be * instantiated for any reason * @return the superclass of the class represented by this object @@ -795,14 +795,14 @@ *
If this object represents a primitive type or void, the * method returns an array of length 0. *
* @throws GenericSignatureFormatError
* @throws java.lang.reflect.GenericSignatureFormatError
if the generic class signature does not conform to the format
specified in the Java Virtual Machine Specification, 3rd edition
- @throws TypeNotPresentException if any of the generic
superinterfaces refers to a non-existent type declaration
* @throws MalformedParameterizedTypeException if any of the
* generic superinterfaces refer to a parameterized type that
cannot
* be instantiated for any reason
* @throws java.lang.reflect.MalformedParameterizedTypeException
* if any of the generic superinterfaces refer to a parameterized
* type that cannot be instantiated for any reason
- @return an array of interfaces implemented by this class
- @since 1.5 */
- Previous message: Patching serviceloader
- Next message: Review request for 6857803 Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces}
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]