Review request for 6857803 Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces}
Joe Darcy
Joe.Darcy at Sun.COM
Tue Jul 7 04:57:54 UTC 2009
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 @@
* <p>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
*/
More information about the core-libs-dev
mailing list