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

Reviewed-by: wetmore, smarks, dfuchs, prr, alanb, mchung
2022-04-28 18:00:34 +00:00 · 2022-04-28 18:00:34 +00:00 · bba456a8db
commit bba456a8db
parent b9d1e85151
40 changed files with 102 additions and 26 deletions
--- a/src/java.base/share/classes/java/lang/ClassValue.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/lang/InheritableThreadLocal.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ThreadLocal.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ref/PhantomReference.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ref/Reference.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ref/ReferenceQueue.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ref/SoftReference.java
+++ b/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
--- a/src/java.base/share/classes/java/lang/ref/WeakReference.java
+++ b/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
--- a/src/java.base/share/classes/java/nio/file/FileVisitor.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/nio/file/SecureDirectoryStream.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/nio/file/WatchEvent.java
+++ b/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
--- a/src/java.base/share/classes/java/security/PrivilegedAction.java
+++ b/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
--- a/src/java.base/share/classes/java/security/PrivilegedExceptionAction.java
+++ b/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
--- a/src/java.base/share/classes/java/util/AbstractCollection.java
+++ b/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
--- a/src/java.base/share/classes/java/util/AbstractList.java
+++ b/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
--- a/src/java.base/share/classes/java/util/AbstractMap.java
+++ b/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>
--- a/src/java.base/share/classes/java/util/AbstractSequentialList.java
+++ b/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
--- a/src/java.base/share/classes/java/util/Dictionary.java
+++ b/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()
--- a/src/java.base/share/classes/java/util/EnumMap.java
+++ b/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
--- a/src/java.base/share/classes/java/util/EnumSet.java
+++ b/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
--- a/src/java.base/share/classes/java/util/Enumeration.java
+++ b/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()
--- a/src/java.base/share/classes/java/util/EventListenerProxy.java
+++ b/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>
--- a/src/java.base/share/classes/java/util/IdentityHashMap.java
+++ b/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
--- a/src/java.base/share/classes/java/util/ListIterator.java
+++ b/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
--- a/src/java.base/share/classes/java/util/Map.java
+++ b/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
     */
--- a/src/java.base/share/classes/java/util/Spliterators.java
+++ b/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
     */
--- a/src/java.base/share/classes/java/util/Stack.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/util/concurrent/CompletionService.java
+++ b/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> {
--- a/src/java.base/share/classes/java/util/concurrent/CompletionStage.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/util/concurrent/ConcurrentHashMap.java
+++ b/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>
--- a/src/java.base/share/classes/java/util/concurrent/CountedCompleter.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/util/concurrent/ExecutorCompletionService.java
+++ b/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> {
--- a/src/java.base/share/classes/java/util/concurrent/ForkJoinTask.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/util/concurrent/RecursiveTask.java
+++ b/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
 */
--- a/src/java.base/share/classes/java/util/random/RandomGeneratorFactory.java
+++ b/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
--- a/src/java.desktop/share/classes/javax/swing/Painter.java
+++ b/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
 */
--- a/src/java.desktop/share/classes/javax/swing/plaf/nimbus/State.java
+++ b/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);
--- a/src/java.management/share/classes/javax/management/openmbean/ArrayType.java
+++ b/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
 */
--- a/src/java.management/share/classes/javax/management/openmbean/SimpleType.java
+++ b/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> {
--- a/src/java.naming/share/classes/javax/naming/NamingEnumeration.java
+++ b/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