RFR: 8361316: javadoc tool fails with an exception for an inheritdoc on throws clause of a constructor
Hannes Wallnöfer
hannesw at openjdk.org
Wed Jul 30 15:41:28 UTC 2025
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.
-------------
Commit messages:
- 8361316: javadoc tool fails with an exception for an inheritdoc on throws clause of a constructor
Changes: https://git.openjdk.org/jdk/pull/26557/files
Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=26557&range=00
Issue: https://bugs.openjdk.org/browse/JDK-8361316
Stats: 93 lines in 3 files changed: 71 ins; 1 del; 21 mod
Patch: https://git.openjdk.org/jdk/pull/26557.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/26557/head:pull/26557
PR: https://git.openjdk.org/jdk/pull/26557
More information about the javadoc-dev
mailing list