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

Jonathan Gibbons jjg at openjdk.java.net
Tue Apr 26 23:38:42 UTC 2022


On Tue, 26 Apr 2022 22:24:26 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> To enable more complete doclint checking (courtesy @jonathan-gibbons), please review this PR to add type-level @param tags where they are missing.
> 
> To the maintainers of java.util.concurrent, those changes could be separated out in another bug if that would ease maintenance of that code.
> 
> Making these library fixes is a blocker for correcting and expanding the doclint checks (JDK-8285496).
> 
> I'll update copyright years before pushing.

src/java.base/share/classes/java/lang/ClassValue.java line 43:

> 41:  * it can use a {@code ClassValue} to cache information needed to
> 42:  * perform the message send quickly, for each class encountered.
> 43:  * @param <T> type of the derived value

stylistically, compared to other comments, you are missing an initial "the"

-------------

PR: https://git.openjdk.java.net/jdk/pull/8410



More information about the client-libs-dev mailing list