8338014: Improve usage of @JVMS tags in class file API

Reviewed-by: darcy, liach, asotona

Author: Sonia Zaldana Calles

src/java.base/share/classes/java/lang/classfile/AnnotationValue.java

@@ -426,7 +426,7 @@ default ClassDesc classSymbol() {
     }
 
     /**
-     * {@return the tag character for this type as per {@jvms 4.7.16.1}}
+     * {@return the tag character for this type as per JVMS {@jvms 4.7.16.1}}
      */
     char tag();
 

src/java.base/share/classes/java/lang/classfile/Attribute.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -66,7 +66,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models a classfile attribute {@jvms 4.7}.  Many, though not all, subtypes of
+ * Models a classfile attribute (JVMS {@jvms 4.7}).  Many, though not all, subtypes of
  * {@linkplain Attribute} will implement {@link ClassElement}, {@link
  * MethodElement}, {@link FieldElement}, or {@link CodeElement}; attributes that
  * are also elements will be delivered when traversing the elements of the

src/java.base/share/classes/java/lang/classfile/ClassSignature.java

@@ -30,7 +30,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models the generic signature of a class file, as defined by {@jvms 4.7.9}.
+ * Models the generic signature of a class file, as defined by JVMS {@jvms 4.7.9}.
  *
  * @since 22
  */

src/java.base/share/classes/java/lang/classfile/MethodSignature.java

@@ -32,7 +32,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models the generic signature of a method, as defined by {@jvms 4.7.9}.
+ * Models the generic signature of a method, as defined by JVMS {@jvms 4.7.9}.
  *
  * @since 22
  */

src/java.base/share/classes/java/lang/classfile/Opcode.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -29,7 +29,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Describes the opcodes of the JVM instruction set, as described in {@jvms 6.5}.
+ * Describes the opcodes of the JVM instruction set, as described in JVMS {@jvms 6.5}.
  * As well as a number of pseudo-instructions that may be encountered when
  * traversing the instructions of a method.
  *

src/java.base/share/classes/java/lang/classfile/Signature.java

@@ -34,7 +34,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models generic Java type signatures, as defined in {@jvms 4.7.9.1}.
+ * Models generic Java type signatures, as defined in JVMS {@jvms 4.7.9.1}.
  *
  * @sealedGraph
  * @since 22

src/java.base/share/classes/java/lang/classfile/TypeAnnotation.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -60,7 +60,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models an annotation on a type use, as defined in {@jvms 4.7.19} and {@jvms 4.7.20}.
+ * Models an annotation on a type use, as defined in JVMS {@jvms 4.7.19} and {@jvms 4.7.20}.
  *
  * @see RuntimeVisibleTypeAnnotationsAttribute
  * @see RuntimeInvisibleTypeAnnotationsAttribute
@@ -73,7 +73,7 @@ public sealed interface TypeAnnotation
         permits UnboundAttribute.UnboundTypeAnnotation {
 
     /**
-     * The kind of target on which the annotation appears, as defined in {@jvms 4.7.20.1}.
+     * The kind of target on which the annotation appears, as defined in JVMS {@jvms 4.7.20.1}.
      *
      * @since 22
      */
@@ -773,7 +773,7 @@ sealed interface TypeArgumentTarget extends TargetInfo
 
     /**
      * JVMS: Type_path structure identifies which part of the type is annotated,
-     * as defined in {@jvms 4.7.20.2}
+     * as defined in JVMS {@jvms 4.7.20.2}
      *
      * @since 22
      */
@@ -782,7 +782,7 @@ sealed interface TypePathComponent
             permits UnboundAttribute.TypePathComponentImpl {
 
         /**
-         * Type path kind, as defined in {@jvms 4.7.20.2}
+         * Type path kind, as defined in JVMS {@jvms 4.7.20.2}
          *
          * @since 22
          */

src/java.base/share/classes/java/lang/classfile/attribute/AnnotationDefaultAttribute.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -34,7 +34,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models the {@code AnnotationDefault} attribute {@jvms 4.7.22}, which can
+ * Models the {@code AnnotationDefault} attribute (JVMS {@jvms 4.7.22}), which can
  * appear on methods of annotation types, and records the default value
  * {@jls 9.6.2} for the element corresponding to this method.  Delivered as a
  * {@link MethodElement} when traversing the elements of a {@link MethodModel}.

src/java.base/share/classes/java/lang/classfile/attribute/BootstrapMethodsAttribute.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -35,7 +35,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models the {@code BootstrapMethods} attribute {@jvms 4.7.23}, which serves as
+ * Models the {@code BootstrapMethods} attribute (JVMS {@jvms 4.7.23}), which serves as
  * an extension to the constant pool of a classfile.  Elements of the bootstrap
  * method table are accessed through {@link ConstantPool}.
  * <p>

src/java.base/share/classes/java/lang/classfile/attribute/CodeAttribute.java

@@ -32,7 +32,7 @@
 import jdk.internal.javac.PreviewFeature;
 
 /**
- * Models the {@code Code} attribute {@jvms 4.7.3}, appears on non-native,
+ * Models the {@code Code} attribute (JVMS {@jvms 4.7.3}), appears on non-native,
  * non-abstract methods and contains the bytecode of the method body.  Delivered
  * as a {@link java.lang.classfile.MethodElement} when traversing the elements of a
  * {@link java.lang.classfile.MethodModel}.