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

[Hannes Wallnöfer]

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.

Thanks for the review!

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

There are a bit more in other modules, which is why I though it was a good idea to split it up into subtasks.

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

PR Comment: https://git.openjdk.org/jdk/pull/21611#issuecomment-2427289078