On Wed, 25 Jan 2023 22:38:38 GMT, Jonathan Gibbons <j...@openjdk.org> wrote:
>> It's not a noun. It's an adjective that I had to synthesize for extra >> clarity and closeness to Java Language Specification (JLS). The English >> version of that entry is as follows: >> >> doclet.throwsInheritDocUnsupported=@inheritDoc is not supported for >> exception-type type parameters \ >> that are not declared by a method; document such exception types directly >> >> JLS _8.4.6. Method Throws_ defines BNF which conveniently labels elements, a >> list of which may appear in the `throws` clause, as `ExceptionType`. To make >> it more English-like and separate two otherwise consecutive occurrences of >> "type" in that sentence, I split the words with a hyphen and lower-cased >> them: exception-type. >> >> @jonathan-gibbons thoughts? > > While the text is technically correct, it may not be as clear as it could be > to all folk that will read this message for whom English is not their primary > language. > > I would suggest translating the phrase as if it were something like > > @inheritDoc is not supported for type parameters that are exception types and > not declared by a method > > > and secondarily, changing the English resource to something like that as well. Updated this line with `exception-type` translated. Hopefully this will be addressed in future drops with changes to the translation tool after some bug fixes. ------------- PR: https://git.openjdk.org/jdk20/pull/116
