RFR: 8342827: Fix order of @param tags in other modules
Jaikiran Pai
jpai at openjdk.org
Thu Oct 24 11:42:06 UTC 2024
On Tue, 22 Oct 2024 13:36:43 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.
src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java line 2:
> 1: /*
> 2: * Copyright (c) 2024, Oracle and/or its affiliates. All rights reserved.
Hello Hans, this looks like an oversight - the copyright year update should have retained the 2013 and additionally introduced 2024.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/21637#discussion_r1814810579
More information about the compiler-dev
mailing list