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

Reviewed-by: wetmore, smarks, dfuchs, prr, alanb, mchung
This commit is contained in:
Joe Darcy 2022-04-28 18:00:34 +00:00
parent b9d1e85151
commit bba456a8db
40 changed files with 102 additions and 26 deletions

View file

@ -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
*/

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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