[jdk8u-ri] RFR: 8285400: Add '@apiNote' to the APIs defined in Java SE 8 MR 3
Bradford Wetmore
wetmore at openjdk.java.net
Tue Apr 26 00:26:57 UTC 2022
On Mon, 25 Apr 2022 23:33:25 GMT, Valerie Peng <valeriep at openjdk.org> wrote:
>> This change adds "apiNote This method is defined in Java SE 8 Maintenance Release 3." to the doc comments of the new APIs added with the following changesets in Java SE MR3 :
>>
>> 1. https://hg.openjdk.java.net/jdk8u/jdk8u41/jdk/rev/b26b096d4c89
>> 2. https://hg.openjdk.java.net/jdk8u/jdk8u41/jdk/rev/6bada58189de
>
> jdk/src/share/classes/java/security/Signature.java line 587:
>
>> 585: * {@code InvalidKeyException} is thrown.
>> 586: *
>> 587: * @apiNote This method is defined in Java SE 8 Maintenance Release 3.
>
> Hmm, there are other pkg private methods added in the maintenance release which do not have the `@since` javadoc tag. For consistency sake, maybe removing the `@since` tag here and no need to add `@apiNote` then?
I apparently let this slip through, this `@since` should not have been there. Please remove it and the `@apiNote`. Thanks.
-------------
PR: https://git.openjdk.java.net/jdk8u-ri/pull/7
More information about the jdk8u-dev
mailing list