RFR: 8361316: javadoc tool fails with an exception for an inheritdoc on throws clause of a constructor

[Nizar Benalla]

On Wed, 30 Jul 2025 15:35:29 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> Please review a simple fix for a javadoc failure when `{@inheritDoc}` is placed in the `@throws` tag of a constructor. 
> 
> `{@inheritDoc}` tags in invalid locations are treated as warnings, so we add a check for the warning and ignore the `{@inheritDoc}` when rendering the `@throws` tag.
> 
> The test also checks `{@inheritDoc}` tags in a few other locations, such as field descriptions, constructor descriptions, and `@param` tags of constructors. The patch also includes some whitespace cleanup in the warning message and the existing tests.

I think this looks good.

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

Marked as reviewed by nbenalla (Committer).

PR Review: https://git.openjdk.org/jdk/pull/26557#pullrequestreview-3075177059