RFR: 8342827: Fix order of @param tags in other modules [v2]

[Iris Clark]

On Thu, 24 Oct 2024 12:17:41 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

>> Please review a doc-only change to fix the order of javadoc @param tags in in various OpenJDK modules. This is the third and last PR to fix the order of @param tags in OpenJDK libraries.
>> 
>> 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.
>> 
>> I compared the generated API docs built with this branch with API docs built from master branch to make sure they are identical.
>
> Hannes Wallnöfer has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Fix copyright header

Confirmed changes only re-order @param declarations.
 
Recommend @JoeWang-Java to review changes to java.xml since portions of that module are maintained in an upstream repository.

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

Marked as reviewed by iris (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/21637#pullrequestreview-2392918255