RFR: 8285488: Improve DocFinder [v3]

[Pavel Rappo]

On Mon, 24 Oct 2022 20:34:03 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/InheritableTaglet.java line 40:
> 
>> 38: public interface InheritableTaglet extends Taglet {
>> 39: 
>> 40:     Output inherit(Element owner, DocTree tag, boolean isFirstSentence, BaseConfiguration configuration);
> 
> It would be nice to have a javadoc comment describing this new method.

This will be refactored in upcoming PRs, for now I believe a simple comment would do.

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

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