8332103: since-checker - Add missing @ since tags to java.desktop

Reviewed-by: tr, aivanov

Author: nizarbenalla

src/java.desktop/share/classes/java/awt/geom/Path2D.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2006, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2006, 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
@@ -292,6 +292,9 @@ public Float(Shape s, AffineTransform at) {
             }
         }
 
+        /**
+         * @since 10
+         */
         @Override
         public final void trimToSize() {
             // trim arrays:
@@ -1178,6 +1181,9 @@ public Double(Shape s, AffineTransform at) {
             }
         }
 
+        /**
+         * @since 10
+         */
         @Override
         public final void trimToSize() {
             // trim arrays:

src/java.desktop/share/classes/java/beans/package-info.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 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
@@ -108,5 +108,7 @@
  *         Long-Term Persistence</a>, an article in
  *         <em>The Swing Connection</em>.</li>
  * </ul>
+ *
+ * @since 1.1
  */
 package java.beans;

src/java.desktop/share/classes/javax/swing/DefaultComboBoxModel.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 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
@@ -183,6 +183,8 @@ public void removeAllElements() {
      *
      * @param c the collection which contains the elements to add
      * @throws NullPointerException if {@code c} is null
+     *
+     * @since 11
      */
     public void addAll(Collection<? extends E> c) {
         if (c.isEmpty()) {
@@ -205,6 +207,8 @@ public void addAll(Collection<? extends E> c) {
      * @throws ArrayIndexOutOfBoundsException if {@code index} does not
      * fall within the range of number of elements currently held
      * @throws NullPointerException if {@code c} is null
+     *
+     * @since 11
      */
     public void addAll(int index, Collection<? extends E> c) {
         if (index < 0 || index > getSize()) {

src/java.desktop/share/classes/javax/swing/DefaultListModel.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, 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
@@ -530,6 +530,8 @@ public void removeRange(int fromIndex, int toIndex) {
      *
      * @param c the collection which contains the elements to add
      * @throws NullPointerException if {@code c} is null
+     *
+     * @since 11
      */
     public void addAll(Collection<? extends E> c) {
         if (c.isEmpty()) {
@@ -552,6 +554,8 @@ public void addAll(Collection<? extends E> c) {
      * @throws ArrayIndexOutOfBoundsException if {@code index} does not
      * fall within the range of number of elements currently held
      * @throws NullPointerException if {@code c} is null
+     *
+     * @since 11
      */
     public void addAll(int index, Collection<? extends E> c) {
         if (index < 0 || index > getSize()) {

src/java.desktop/share/classes/javax/swing/JSlider.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2023, 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
@@ -1461,6 +1461,8 @@ public AccessibleStateSet getAccessibleStateSet() {
          *
          * @param e  a {@code ChangeEvent} object. Must not be {@code null}
          * @throws NullPointerException if the parameter is {@code null}
+         *
+         * @since 16
          */
         public void stateChanged(ChangeEvent e) {
             if (e == null) {
@@ -1561,6 +1563,8 @@ public AccessibleAction getAccessibleAction() {
          * which decrements the slider value
          *
          * @return the zero-based number of Actions in this object
+         *
+         * @since 17
          */
         public int getAccessibleActionCount() {
             return 2;
@@ -1572,6 +1576,8 @@ public int getAccessibleActionCount() {
          * @param i zero-based index of the actions
          * @return a String description of the action
          * @see #getAccessibleActionCount
+         *
+         * @since 17
          */
         public String getAccessibleActionDescription(int i) {
             if (i == 0) {
@@ -1590,6 +1596,8 @@ public String getAccessibleActionDescription(int i) {
          * action (index 1) is AccessibleAction.DECREMENT.
          * @return true if the action was performed, otherwise false
          * @see #getAccessibleActionCount
+         *
+         * @since 17
          */
         public boolean doAccessibleAction(int i) {
             if (i < 0 || i > 1) {

src/java.desktop/share/classes/javax/swing/package-info.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 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
@@ -149,5 +149,7 @@
  * </ul>
  *
  * @serial exclude
+ *
+ * @since 1.2
  */
 package javax.swing;

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicSliderUI.java

@@ -150,6 +150,8 @@ public class BasicSliderUI extends SliderUI{
 
     /**
      * Constructs a {@code BasicSliderUI}.
+     *
+     * @since 16
      * @deprecated This constructor was exposed erroneously and will be removed in a future release.
      *             Use {@link #BasicSliderUI(JSlider)} instead.
      */

src/java.desktop/share/classes/javax/swing/plaf/synth/package-info.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 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
@@ -139,5 +139,7 @@
  *   <bind style="style" type="region" key="Table"/>
  *   <bind style="style" type="region" key="List"/>
  * }</pre>
+ *
+ * @since 1.5
  */
 package javax.swing.plaf.synth;

src/java.desktop/share/classes/javax/swing/text/DefaultEditorKit.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2023, 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
@@ -648,6 +648,8 @@ public void write(Writer out, Document doc, int pos, int len)
      * beginning of the previous line if the caret is
      * already at the beginning of the line.
      * @see #getActions
+     *
+     * @since 20
      */
     public static final String beginLineUpAction = "caret-begin-line-and-up";
 
@@ -657,6 +659,8 @@ public void write(Writer out, Document doc, int pos, int len)
      * end of the next line if the caret is already
      * at the end of the line.
      * @see #getActions
+     *
+     * @since 20
      */
     public static final String endLineDownAction = "caret-end-line-and-down";