8285676: Add missing @param tags for type parameters on classes and interfaces

Reviewed-by: wetmore, smarks, dfuchs, prr, alanb, mchung

src/java.base/share/classes/java/lang/ClassValue.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2022, 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
@@ -40,6 +40,7 @@ import static java.lang.ClassValue.ClassValueMap.probeBackupLocations;
  * table for each class encountered at a message send call site,
  * it can use a {@code ClassValue} to cache information needed to
  * perform the message send quickly, for each class encountered.
+ * @param <T> the type of the derived value
  * @author John Rose, JSR 292 EG
  * @since 1.7
  */

src/java.base/share/classes/java/lang/InheritableThreadLocal.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2022, 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
@@ -44,6 +44,7 @@ import java.lang.ref.*;
  * Thread#Thread(ThreadGroup,Runnable,String,long,boolean) thread}, it is
  * possible to <i>opt out</i> of receiving initial values for inheritable
  * thread-local variables.
+ * @param <T> the type of the inheritable thread local's value
  *
  * @author  Josh Bloch and Doug Lea
  * @see     ThreadLocal

src/java.base/share/classes/java/lang/ThreadLocal.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -69,6 +69,7 @@ import java.util.function.Supplier;
  * instance is accessible; after a thread goes away, all of its copies of
  * thread-local instances are subject to garbage collection (unless other
  * references to these copies exist).
+ * @param <T> the type of the thread local's value
  *
  * @author  Josh Bloch and Doug Lea
  * @since   1.2

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

@@ -45,6 +45,7 @@ import jdk.internal.vm.annotation.IntrinsicCandidate;
  * phantom reference always returns {@code null}.
  * The {@link #refersTo(Object) refersTo} method can be used to test
  * whether some object is the referent of a phantom reference.
+ * @param<T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

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

@@ -36,6 +36,7 @@ import jdk.internal.ref.Cleaner;
  * operations common to all reference objects.  Because reference objects are
  * implemented in close cooperation with the garbage collector, this class may
  * not be subclassed directly.
+ * @param<T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -31,6 +31,7 @@ import jdk.internal.misc.VM;
 /**
  * Reference queues, to which registered reference objects are appended by the
  * garbage collector after the appropriate reachability changes are detected.
+ * @param<T> the type of the reference object
  *
  * @author   Mark Reinhold
  * @since    1.2

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

@@ -56,6 +56,7 @@ package java.lang.ref;
  * prevent its most recently used entries from being discarded by keeping
  * strong referents to those entries, leaving the remaining entries to be
  * discarded at the discretion of the garbage collector.
+ * @param<T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

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

@@ -40,6 +40,7 @@ package java.lang.ref;
  * weakly-reachable objects to be finalizable.  At the same time or at some
  * later time it will enqueue those newly-cleared weak references that are
  * registered with reference queues.
+ * @param<T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.base/share/classes/java/nio/file/FileVisitor.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2022, 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
@@ -91,6 +91,7 @@ import java.io.IOException;
  *             }
  *         });
  * </pre>
+ * @param <T> the type of file/directory
  *
  * @since 1.7
  */

src/java.base/share/classes/java/nio/file/SecureDirectoryStream.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2022, 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
@@ -52,6 +52,7 @@ import java.io.IOException;
  * performed using the path obtained by resolving the given relative path
  * against the <i>original path</i> of the directory (irrespective of if the
  * directory is moved since it was opened).
+ * @param <T> The type of element returned by the iterator
  *
  * @since   1.7
  */

src/java.base/share/classes/java/nio/file/WatchEvent.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2022, 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
@@ -48,6 +48,7 @@ public interface WatchEvent<T> {
 
     /**
      * An event kind, for the purposes of identification.
+     * @param <T> The type of the context object associated with the event
      *
      * @since 1.7
      * @see StandardWatchEventKinds

src/java.base/share/classes/java/security/PrivilegedAction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2022, 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
@@ -33,6 +33,7 @@ package java.security;
  * computations that do not throw checked exceptions; computations that
  * throw checked exceptions must use {@code PrivilegedExceptionAction}
  * instead.
+ * @param <T> the type of the result of running the computation
  *
  * @since 1.2
  * @see AccessController

src/java.base/share/classes/java/security/PrivilegedExceptionAction.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2022, 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,6 +34,7 @@ package java.security;
  * used only for computations that throw checked exceptions;
  * computations that do not throw
  * checked exceptions should use {@code PrivilegedAction} instead.
+ * @param <T> the type of the result of running the computation
  *
  * @since 1.2
  * @see AccessController

src/java.base/share/classes/java/util/AbstractCollection.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -54,6 +54,8 @@ import jdk.internal.util.ArraysSupport;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements in this collection
+ *
  * @author  Josh Bloch
  * @author  Neal Gafter
  * @see Collection

src/java.base/share/classes/java/util/AbstractList.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -65,6 +65,8 @@ import java.util.function.Consumer;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements in this list
+ *
  * @author  Josh Bloch
  * @author  Neal Gafter
  * @since 1.2

src/java.base/share/classes/java/util/AbstractMap.java

@@ -598,6 +598,9 @@ public abstract class AbstractMap<K,V> implements Map<K,V> {
      * arrays of {@code SimpleEntry} instances in method
      * {@code Map.entrySet().toArray}.
      *
+     * @param <K> the type of key
+     * @param <V> the type of the value
+     *
      * @since 1.6
      */
     public static class SimpleEntry<K,V>
@@ -741,6 +744,8 @@ public abstract class AbstractMap<K,V> implements Map<K,V> {
      * {@link Map#entry Map::entry} and {@link Map.Entry#copyOf Map.Entry::copyOf}
      * methods.
      *
+     * @param <K> the type of the keys
+     * @param <V> the type of the value
      * @since 1.6
      */
     public static class SimpleImmutableEntry<K,V>

src/java.base/share/classes/java/util/AbstractSequentialList.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -57,6 +57,8 @@ package java.util;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements in this list
+ *
  * @author  Josh Bloch
  * @author  Neal Gafter
  * @see Collection

src/java.base/share/classes/java/util/Dictionary.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2022, 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
@@ -39,6 +39,9 @@ package java.util;
  * <strong>NOTE: This class is obsolete.  New implementations should
  * implement the Map interface, rather than extending this class.</strong>
  *
+ * @param <K> the type of keys
+ * @param <V> the type of mapped values
+ *
  * @see     java.util.Map
  * @see     java.lang.Object#equals(java.lang.Object)
  * @see     java.lang.Object#hashCode()

src/java.base/share/classes/java/util/EnumMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2022, 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
@@ -71,6 +71,9 @@ import jdk.internal.access.SharedSecrets;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <K> the enum type of keys maintained by this map
+ * @param <V> the type of mapped values
+ *
  * @author Josh Bloch
  * @see EnumSet
  * @since 1.5

src/java.base/share/classes/java/util/EnumSet.java

@@ -72,6 +72,8 @@ import jdk.internal.access.SharedSecrets;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <E> the enum type of elements maintained by this set
+ *
  * @author Josh Bloch
  * @since 1.5
  * @see EnumMap

src/java.base/share/classes/java/util/Enumeration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1994, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1994, 2022, 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
@@ -49,6 +49,8 @@ package java.util;
  * adapt an {@code Enumeration} to an {@code Iterator} by using the
  * {@link #asIterator} method.
  *
+ * @param <E> the type of elements returned by this enumeration
+ *
  * @see     java.util.Iterator
  * @see     java.io.SequenceInputStream
  * @see     java.util.Enumeration#nextElement()

src/java.base/share/classes/java/util/EventListenerProxy.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2004, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2022, 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
@@ -48,6 +48,8 @@ package java.util;
  * If the calling method is interested in retrieving the named property
  * then it would have to test the element to see if it is a proxy class.
  *
+ * @param <T> the type of {@code EventListener} being wrapped
+ *
  * @since 1.4
  */
 public abstract class EventListenerProxy<T extends EventListener>

src/java.base/share/classes/java/util/IdentityHashMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2022, 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
@@ -130,6 +130,9 @@ import jdk.internal.access.SharedSecrets;
  * and operation mixes, this class will yield better performance than
  * {@link HashMap}, which uses <i>chaining</i> rather than linear-probing.
  *
+ * @param <K> the type of keys maintained by this map
+ * @param <V> the type of mapped values
+ *
  * @see     System#identityHashCode(Object)
  * @see     Object#hashCode()
  * @see     Collection

src/java.base/share/classes/java/util/ListIterator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -49,6 +49,8 @@ package java.util;
  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
  * Java Collections Framework</a>.
  *
+ * @param <E> the type of elements returned by this list iterator
+ *
  * @author  Josh Bloch
  * @see Collection
  * @see List

src/java.base/share/classes/java/util/Map.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2022, 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
@@ -421,6 +421,9 @@ public interface Map<K, V> {
      * var entries = map.entrySet().stream().map(Map.Entry::copyOf).toList()
      * }</pre>
      *
+     * @param <K> the type of the key
+     * @param <V> the type of the value
+     *
      * @see Map#entrySet()
      * @since 1.2
      */

src/java.base/share/classes/java/util/Spliterators.java

@@ -1358,6 +1358,8 @@ public final class Spliterators {
      * extending this class, such as when there is already an iterator
      * available to use.
      *
+     * @param <T> the type of elements returned by this Spliterator
+     *
      * @see #spliterator(Iterator, long, int)
      * @since 1.8
      */

src/java.base/share/classes/java/util/Stack.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1994, 2022, 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
@@ -42,6 +42,8 @@ package java.util;
  * <pre>   {@code
  *   Deque<Integer> stack = new ArrayDeque<Integer>();}</pre>
  *
+ * @param <E> Type of component elements
+ *
  * @author  Jonathan Payne
  * @since   1.0
  */

src/java.base/share/classes/java/util/concurrent/CompletionService.java

@@ -58,6 +58,8 @@ package java.util.concurrent;
  * actions taken by that task, which in turn <i>happen-before</i>
  * actions following a successful return from the corresponding {@code take()}.
  *
+ * @param <V> the type of values the tasks of this service produce and consume
+ *
  * @since 1.5
  */
 public interface CompletionService<V> {

src/java.base/share/classes/java/util/concurrent/CompletionStage.java

@@ -145,6 +145,8 @@ import java.util.function.Function;
  * enables interoperability among different implementations of this
  * interface by providing a common conversion type.
  *
+ * @param <T> the type of values the stage produces or consumes
+ *
  * @author Doug Lea
  * @since 1.8
  */

src/java.base/share/classes/java/util/concurrent/ConcurrentHashMap.java

@@ -4587,6 +4587,9 @@ public class ConcurrentHashMap<K,V> extends AbstractMap<K,V>
      * {@link #newKeySet() newKeySet()},
      * {@link #newKeySet(int) newKeySet(int)}.
      *
+     * @param <K> the type of keys
+     * @param <V> the type of values in the backing map
+     *
      * @since 1.8
      */
     public static final class KeySetView<K,V> extends CollectionView<K,V,K>

src/java.base/share/classes/java/util/concurrent/CountedCompleter.java

@@ -420,6 +420,8 @@ import java.lang.invoke.VarHandle;
  * new HeaderBuilder(p, ...).fork();
  * new BodyBuilder(p, ...).fork();}</pre>
  *
+ * @param <T> the type of the result of the completer
+ *
  * @since 1.8
  * @author Doug Lea
  */

src/java.base/share/classes/java/util/concurrent/ExecutorCompletionService.java

@@ -98,6 +98,8 @@ package java.util.concurrent;
  *     use(result);
  * }}</pre>
  *
+ * @param <V> the type of values the tasks of this service produce and consume
+ *
  * @since 1.5
  */
 public class ExecutorCompletionService<V> implements CompletionService<V> {

src/java.base/share/classes/java/util/concurrent/ForkJoinTask.java

@@ -198,6 +198,8 @@ import java.util.concurrent.locks.LockSupport;
  * sensible to serialize tasks only before or after, but not during,
  * execution. Serialization is not relied on during execution itself.
  *
+ * @param <V> the type of the result of the task
+ *
  * @since 1.7
  * @author Doug Lea
  */

src/java.base/share/classes/java/util/concurrent/RecursiveTask.java

@@ -62,6 +62,8 @@ package java.util.concurrent;
  * minimum granularity size (for example 10 here) for which you always
  * sequentially solve rather than subdividing.
  *
+ * @param <V> the type of the result of the task
+ *
  * @since 1.7
  * @author Doug Lea
  */

src/java.base/share/classes/java/util/random/RandomGeneratorFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2022, 2022, 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
@@ -99,6 +99,8 @@ import jdk.internal.util.random.RandomSupport.RandomGeneratorProperties;
  *     System.out.println(rng.nextLong());
  * }
  *
+ * @param <T> type of created random generator
+ *
  * @since 17
  *
  * @see java.util.random

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2022, 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
@@ -58,6 +58,8 @@ import java.awt.Graphics2D;
  *
  * <p>This interface makes no guarantees of threadsafety.</p>
  *
+ * @param <T> type of the configuration parameter
+ *
  * @author rbair
  * @since 1.7
  */

src/java.desktop/share/classes/javax/swing/plaf/nimbus/State.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2022, 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
@@ -69,6 +69,8 @@ import javax.swing.plaf.synth.SynthConstants;
  *         }
  *     }
  * </code></pre>
+ *
+ * @param <T> type of component whose state is to be queried
  */
 public abstract class State<T extends JComponent>{
     static final Map<String, StandardState> standardStates = new HashMap<String, StandardState>(7);

src/java.management/share/classes/javax/management/openmbean/ArrayType.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2022, 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
@@ -92,6 +92,8 @@ import java.lang.reflect.Array;
  * ArrayType<String[][][]> a19 = new ArrayType<String[][][]>(1, a18);
  * }</pre>
  *
+ * @param <T> the Java component type that arrays described by this ArrayType must
+ * have.
  *
  * @since 1.5
  */

src/java.management/share/classes/javax/management/openmbean/SimpleType.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2022, 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
@@ -55,6 +55,9 @@ import javax.management.ObjectName;
  * In other words, its methods <code>getClassName</code>, <code>getTypeName</code> and <code>getDescription</code>
  * all return the same string value <i>className</i>.
  *
+ * @param <T> the Java type that values described by this SimpleType must
+ * have.
+ *
  * @since 1.5
  */
 public final class SimpleType<T> extends OpenType<T> {

src/java.naming/share/classes/javax/naming/NamingEnumeration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2022, 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
@@ -70,6 +70,8 @@ import java.util.Enumeration;
   * @author Rosanna Lee
   * @author Scott Seligman
   *
+  * @param <T> the type of elements returned by this enumeration
+  *
   * @see Context#list
   * @see Context#listBindings
   * @see javax.naming.directory.DirContext#search