On Tue, 1 Nov 2022 14:45:49 GMT, Pavel Rappo <pra...@openjdk.org> wrote:

>> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/ThrowsTaglet.java
>>  line 782:
>> 
>>> 780:         }
>>> 781:         var enclosingElementDescription = 
>>> detailedDescriptionOf(e.getEnclosingElement());
>>> 782:         return enclosingElementDescription + " " + 
>>> thisElementDescription;
>> 
>> A named package is enclosed by a module, although it may be the unnamed 
>> module for >= JDK 9.
>> A well-formed named module never has an unnamed package.
>> 
>> Consider return empty string from the switch and dealing with that in the 
>> `return` statement.
>> 
>> That being said, who uses this info where: you're including the raw element 
>> kind in the result, so is this mostly for debugging?
>
> It will need to be better stringified and i18n-zed. That output is not for 
> debugging, it's for diagnosing.

I see the preceding TODOs.

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

PR: https://git.openjdk.org/jdk/pull/10746

Reply via email to