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

[Joe Darcy]

On Thu, 28 Apr 2022 08:10:38 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Respond to more review feedback.
>
> src/java.base/share/classes/java/nio/file/WatchEvent.java line 51:
> 
>> 49:     /**
>> 50:      * An event kind, for the purposes of identification.
>> 51:      * @param <T> the type of the context value
> 
> This is okay but the it differs slightly to the type parameters specified further up. I think the issue here is that it was just wasn't copied down to WatchEvent.Kind.

Okay -- I'll for the T type parameter of the Kind interface I'll reuse the wording of the T type parameter of the enclosing WatchEvent interface. (The type variable on Kind could be renamed to show that the two type parameters are distinct.)

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

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