[jdk8u-ri] RFR: 8285400: Add '@apiNote' to the APIs defined in Java SE 8 MR 3

Valerie Peng valeriep at openjdk.java.net
Mon Apr 25 23:36:55 UTC 2022


On Mon, 25 Apr 2022 21:02:05 GMT, Poonam Bajaj <poonam 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?

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

PR: https://git.openjdk.java.net/jdk8u-ri/pull/7


More information about the jdk8u-dev mailing list