RFR: JDK-8285869: Selective cleanup in doclint Checker class [v2]
Jonathan Gibbons
jjg at openjdk.java.net
Tue May 3 22:41:00 UTC 2022
On Tue, 3 May 2022 22:16:25 GMT, Pavel Rappo <prappo at openjdk.org> wrote:
>> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
>>
>> address review feedback
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclint/Checker.java line 866:
>
>> 864: if (paramElement == null) {
>> 865: switch (env.currElement.getKind()) {
>> 866: case CLASS, INTERFACE -> {
>
> A record can be generic too.
Yes, but RECORD is handled in a different case, along with METHOD and CONSTRUCTOR, because it can have "plain" `@param` as well as type-parameter `@param`. In contrast, a class or interface can only have type-parameter `@param` and never plain `@param`.
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclint/Checker.java line 1230:
>
>> 1228: for (DocTree d: list) {
>> 1229: switch (d.getKind()) {
>> 1230: case TEXT -> {
>
> Using `switch` here seems overkill.
I almost fixed that one earlier. OK, I'll do that too. It was over-zealous use of use of unqualified names in an enum-switch
-------------
PR: https://git.openjdk.java.net/jdk/pull/8460
More information about the compiler-dev
mailing list