On Mon, 29 Apr 2024 17:46:24 GMT, Nizar Benalla <d...@openjdk.org> wrote:
> 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 I suggest dropping all the changes that are irrelevant to `@since` from this PR, unless you have PRs with similar mixed changes integrated. As far as I know, `@since` is not a normative part of documentation, whereas `@throws` is. So the latter is a bigger change and would require more scrutiny and more area experts during review. In the future, we might want to have yet another aid/tool: a "`@throws` checker" that finds all overriding methods that do not declare some of the unchecked exceptions that the methods they override do. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/18954#discussion_r1583618873