On Tue, 1 Nov 2022 14:23:54 GMT, Pavel Rappo <pra...@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
