RFR: 8285488: Improve DocFinder [v3]

[Pavel Rappo]

On Mon, 24 Oct 2022 21:01:30 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Pavel Rappo has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   fix: test failed due to filesystem handling issues
>>   
>>   Filed 8295543 to track that filesystem issue and fixed the test to make
>>   sure the package cannot be confused with the type parameter, whose
>>   name is not pertinent to the test anyway.
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/ThrowsTaglet.java line 124:
> 
>> 122:      * thrown exceptions and, hence, document them.
>> 123:      */
>> 124: 
> 
> Would it make sense to add a 3rd section about characteristics of `@throws` tags to be taken into account, citing issues like repeatability, subtypes, and inheritance?

Not sure. I'm trying to keep code documentation to a minimum, really. Ideally, all a maintainer would need is "Documentation Comment Specification for the Standard Doclet" and code. I know you are not a fan of such a style, but DRY is good.

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

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