changeset 50925:d853e7821dcb jep-334

missing jvms tags
author vromero
date Fri, 01 Jun 2018 07:57:11 -0700
parents 4ead060db982
children 07f2229cb09c
files src/java.base/share/classes/java/lang/Enum.java src/java.base/share/classes/java/lang/invoke/FieldTypeDescriptor.java src/java.base/share/classes/java/lang/invoke/MethodTypeDescriptor.java src/java.base/share/classes/java/lang/invoke/TypeDescriptor.java src/java.base/share/classes/java/lang/invoke/VarHandle.java
diffstat 5 files changed, 10 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/lang/Enum.java	Fri Jun 01 07:30:11 2018 -0700
+++ b/src/java.base/share/classes/java/lang/Enum.java	Fri Jun 01 07:57:11 2018 -0700
@@ -292,6 +292,7 @@
          * @param constantType a {@link ClassDesc} describing the {@code enum} class
          * @param constantName the name of the enum constant, as per JVMS 4.2.2
          * @throws NullPointerException if any argument is null
+         * @jvms 4.2.2 Unqualified Names
          */
         private EnumDesc(ClassDesc constantType, String constantName) {
             super(ConstantDescs.BSM_ENUM_CONSTANT, requireNonNull(constantName), requireNonNull(constantType));
@@ -305,6 +306,7 @@
          * @param constantName the name of the enum constant, as per JVMS 4.2.2
          * @return the nominal descriptor
          * @throws NullPointerException if any argument is null
+         * @jvms 4.2.2 Unqualified Names
          */
         public static<E extends Enum<E>> EnumDesc<E> of(ClassDesc enumClass,
                                                         String constantName) {
@@ -335,6 +337,7 @@
          *                        per JVMS 4.3.2
          * @param constantName The name of the {@code enum} constant
          * @return the {@linkplain EnumDesc}
+         * @jvms 4.3.2 Field Descriptors
          */
         public static EnumDesc<?> constantBootstrap(MethodHandles.Lookup lookup, String name, Class<ClassDesc> clazz,
                                                     String classDescriptor, String constantName) {
--- a/src/java.base/share/classes/java/lang/invoke/FieldTypeDescriptor.java	Fri Jun 01 07:30:11 2018 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/FieldTypeDescriptor.java	Fri Jun 01 07:57:11 2018 -0700
@@ -4,6 +4,7 @@
  * Represents a field type descriptor, as per JVMS 4.3.2.
  *
  * @param <F> the class implementing {@linkplain FieldTypeDescriptor}
+ * @jvms 4.3.2 Field Descriptors
  */
 public interface FieldTypeDescriptor<F extends FieldTypeDescriptor<F>> extends TypeDescriptor {
     /**
--- a/src/java.base/share/classes/java/lang/invoke/MethodTypeDescriptor.java	Fri Jun 01 07:30:11 2018 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/MethodTypeDescriptor.java	Fri Jun 01 07:57:11 2018 -0700
@@ -7,6 +7,7 @@
  *
  * @param <F> the type representing field type descriptors
  * @param <M> the class implementing {@linkplain MethodTypeDescriptor}
+ * @jvms 4.3.3 Method Descriptors
  */
 public interface MethodTypeDescriptor<F extends FieldTypeDescriptor<F>, M extends MethodTypeDescriptor<F, M>>
         extends TypeDescriptor {
--- a/src/java.base/share/classes/java/lang/invoke/TypeDescriptor.java	Fri Jun 01 07:30:11 2018 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/TypeDescriptor.java	Fri Jun 01 07:57:11 2018 -0700
@@ -2,6 +2,8 @@
 
 /**
  * An entity that has a field or method type descriptor, as per JVMS 4.3.2 or 4.3.3.
+ * @jvms 4.3.2 Field Descriptors
+ * @jvms 4.3.3 Method Descriptors
  */
 public interface TypeDescriptor {
     /**
--- a/src/java.base/share/classes/java/lang/invoke/VarHandle.java	Fri Jun 01 07:30:11 2018 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/VarHandle.java	Fri Jun 01 07:57:11 2018 -0700
@@ -2178,6 +2178,7 @@
          *                       for field var handles
          * @param varType a {@link ClassDesc} describing the type of the variable
          * @throws NullPointerException if any required argument is null
+         * @jvms 4.2.2 Unqualified Names
          */
         private VarHandleDesc(Kind kind, String name, ClassDesc declaringClass, ClassDesc varType) {
             super(kind.bootstrapMethod, name,
@@ -2198,6 +2199,7 @@
          * @param fieldType a {@link ClassDesc} describing the type of the field
          * @return the {@linkplain VarHandleDesc}
          * @throws NullPointerException if any of the arguments are null
+         * @jvms 4.2.2 Unqualified Names
          */
         public static VarHandleDesc ofField(ClassDesc declaringClass, String name, ClassDesc fieldType) {
             Objects.requireNonNull(declaringClass);
@@ -2216,6 +2218,7 @@
          * @param fieldType a {@link ClassDesc} describing the type of the field
          * @return the {@linkplain VarHandleDesc}
          * @throws NullPointerException if any of the arguments are null
+         * @jvms 4.2.2 Unqualified Names
          */
         public static VarHandleDesc ofStaticField(ClassDesc declaringClass, String name, ClassDesc fieldType) {
             Objects.requireNonNull(declaringClass);