RFR: 8285488: Improve DocFinder [v4]

[Jonathan Gibbons]

On Tue, 1 Nov 2022 14:23:54 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/resources/doclets.properties line 122:
>> 
>>> 120: doclet.inheritDocWithinInappropriateTag=@inheritDoc cannot be used within this tag
>>> 121: doclet.inheritDocNoDoc=overridden methods do not document exception type {0}
>>> 122: doclet.throwsInheritDocUnsupported=@inheritDoc for exception-type type parameters not declared by a method is unsupported; \
>> 
>> Minor grammar quibble: _not supported_ reads better than _unsupported_.
>> 
>> Even better would be to reorder the message:
>> 
>> @inheritDoc is not supported for exception-type type parameters that are not declared by a method; document such exception types directly
>
> Wouldn't it be harder to read though? _that are not declared ... are not supported_

I was trying to be a bit more specific than just _not supported_, but I'm OK either way

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

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