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

Chen Liang liach at openjdk.org
Fri Aug 1 04:05:54 UTC 2025


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.

The new constraints look good.

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

Marked as reviewed by liach (Reviewer).

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


More information about the javadoc-dev mailing list