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