<i18n dev> RFR: 8330954: Fix remaining `@since` tags in `java.base`

[Nizar Benalla]

On Mon, 29 Apr 2024 17:26:53 GMT, Chen Liang <liach at openjdk.org> wrote:

>> src/java.base/share/classes/java/io/FileInputStream.java line 345:
>> 
>>> 343:      * @throws    IllegalArgumentException {@inheritDoc}
>>> 344:      * @throws    IOException {@inheritDoc}
>>> 345:      * @throws    OutOfMemoryError {@inheritDoc}
>> 
>> Re: inheriting _unchecked_ exception documentation here and elsewhere in this PR
>> 
>> This PR's title suggests that the PR has nothing to do with exception documentation. If you feel that it should be addressed, please file a separate bug and move these changes there.
>> 
>> FWIW, I agree that `@throws ... {@inheritDoc}` for such exceptions are at least worth being considered. It's a common misconception that all exception documentation is inherited automatically.
>
> This is because the tool from #18934 has no easy way to fetch the doc comment from a superclass/superinterface overridden method when this class only has a plain override. Javadoc handles this in complex logic in `VisibleMemberTable`; it's hard for other clients to try to emulate the behavior of doc finding, and the tool just incorrectly assumes such methods (what I have been talking about before) are reusing `@since` from the class docs.

Pavel, can I simply change the PR/issue title to be more descriptive? 
As I want to include the the inherit doc because of the unchecked exceptions, rather than clean this up in a different PR

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

PR Review Comment: https://git.openjdk.org/jdk/pull/18954#discussion_r1583479753