8330954: since-checker - Fix remaining @ since tags in java.base

Reviewed-by: liach, naoto

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

@@ -41,7 +41,11 @@ public sealed interface ClassSignature
     /** {@return the type parameters of this class} */
     List<Signature.TypeParam> typeParameters();
 
-    /** {@return the instantiation of the superclass in this signature} */
+    /**
+     * {@return the instantiation of the superclass in this signature}
+     *
+     * @since 23
+     */
     Signature.ClassTypeSig superclassSignature();
 
     /** {@return the instantiation of the interfaces in this signature} */

src/java.base/share/classes/java/lang/constant/ClassDesc.java

@@ -374,6 +374,9 @@ public sealed interface ClassDesc
      */
     String descriptorString();
 
+    /**
+     * @since 21
+     */
     @Override
     Class<?> resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException;
 

src/java.base/share/classes/java/lang/constant/MethodHandleDesc.java

@@ -207,6 +207,9 @@ public sealed interface MethodHandleDesc
      */
     MethodTypeDesc invocationType();
 
+    /**
+     * @since 21
+     */
     @Override
     MethodHandle resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException;
 

src/java.base/share/classes/java/lang/constant/MethodTypeDesc.java

@@ -222,6 +222,8 @@ public sealed interface MethodTypeDesc
      * @apiNote {@linkplain MethodTypeDesc} can represent method type descriptors
      * that are not representable by {@linkplain MethodType}, such as methods with
      * more than 255 parameter slots, so attempts to resolve these may result in errors.
+     *
+     * @since 21
      */
     @Override
     MethodType resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException;

src/java.base/share/classes/java/lang/foreign/MemorySegment.java

@@ -618,6 +618,8 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
      *     // Take action (e.g. throw an Exception)
      * }
      * }
+     *
+     * @since 23
      */
     long maxByteAlignment();
 

src/java.base/share/classes/java/lang/ref/Reference.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 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
@@ -521,8 +521,6 @@ public abstract sealed class Reference<T>
      *
      * @return never returns normally
      * @throws  CloneNotSupportedException always
-     *
-     * @since 11
      */
     @Override
     protected Object clone() throws CloneNotSupportedException {