RFR: 8339631: Fix block @jls and @jvms tags [v3]

[Chen Liang]

On Mon, 9 Sep 2024 09:19:38 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> This fixes some of the recently discovered [issues] with the block variants of the specification tags. While reviewing, please check the proposed changes against the actual specifications. Since the specifications for JDK 23 are not yet available in the HTML format, you can use the specifications for JDK 22, which are reasonably up-to-date:
>> 
>>   - [JLS]
>>   - [JVMS]
>> 
>> Note that this PR does NOT address any issues with the inline variants of the said tags. Those are harder to check. Even flagging suspicious tags requires a human. If you have some time, consider performing similar checks for inline `@jls` and `@jvms` tags in your area. Thanks.
>> 
>> [issues]: https://bugs.openjdk.org/browse/JDK-8339558
>> [JLS]: https://docs.oracle.com/javase/specs/jls/se22/html/index.html
>> [JVMS]: https://docs.oracle.com/javase/specs/jvms/se22/html/index.html
>
> Pavel Rappo has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Update copyright years
>   
>   Note: any commit hashes below might be outdated due to subsequent
>   history rewriting (e.g. git rebase).
>   
>    + update src/java.base/share/classes/java/lang/ClassLoader.java due to 51ffa5ee21b
>    + update src/java.base/share/classes/java/lang/Record.java due to 51ffa5ee21b
>    + update src/java.base/share/classes/java/lang/StackWalker.java due to 51ffa5ee21b
>    + update src/java.base/share/classes/java/lang/reflect/AccessFlag.java due to 51ffa5ee21b
>    + update src/java.base/share/classes/java/lang/reflect/InvocationHandler.java due to 51ffa5ee21b
>    + update src/java.compiler/share/classes/javax/lang/model/element/NestingKind.java due to 51ffa5ee21b
>    + update src/java.compiler/share/classes/javax/lang/model/type/NullType.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/ClassTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/InstanceOfTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/LiteralTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/MethodTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/ModifiersTree.java due to 2c3d47aad82
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/StatementTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/SwitchExpressionTree.java due to 51ffa5ee21b
>    + update src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java due to 51ffa5ee21b

Marked as reviewed by liach (Reviewer).

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

PR Review: https://git.openjdk.org/jdk/pull/20879#pullrequestreview-2289709280