JDK 13 RFR of JDK-8225353: Add @jls links to java.lang.Enum
Joe Darcy
joe.darcy at oracle.com
Wed Jun 5 16:49:34 UTC 2019
Hello,
As noticed by Jon, the text for java.lang.Enum refers to a section of
the JLS but does not use @jls tags:
"This is the common base class of all Java language enumeration types.
More information about enums, including descriptions of the implicitly
declared methods synthesized by the compiler, can be found in section
8.9 of The Java™ Language Specification."
The javadoc for Enum would be improved if augmented by @jls to
particular sections.
Please review the patch below to do this.
Thanks,
-Joe
diff -r 481999e74cea src/java.base/share/classes/java/lang/Enum.java
--- a/src/java.base/share/classes/java/lang/Enum.java Wed Jun 05
08:24:03 2019 -0700
+++ b/src/java.base/share/classes/java/lang/Enum.java Wed Jun 05
09:44:47 2019 -0700
@@ -59,6 +59,8 @@
* @see Class#getEnumConstants()
* @see java.util.EnumSet
* @see java.util.EnumMap
+ * @jls 8.9 Enum Types
+ * @jls 8.9.3 Enum Members
* @since 1.5
*/
More information about the core-libs-dev
mailing list