RFR: 8342698: Fix order of @param tags in module java.base

Iris Clark iris at openjdk.org
Mon Oct 21 16:16:11 UTC 2024


On Mon, 21 Oct 2024 13:45:47 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> Please review a doc-only change to fix the order of javadoc `@param` tags in module java.base.
> 
> We are working on a javadoc feature to add an opt-in doclint warning for `@param` tags that don't match the order of parameters in the documented element. The warning will be enabled in OpenJDK builds and covers all uses of the `@param` tag, i.e. parameters of executable elements, type parameters, and record components.

Confirmed that these changes simply re-order existing @param tag declarations.

If this corresponds to all the problems in `java.base`, I'm impressed that there are so few of them.

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

Marked as reviewed by iris (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/21611#pullrequestreview-2382595089


More information about the security-dev mailing list