RFR: JDK-8157682: @inheritDoc doesn't work with @exception

Jonathan Gibbons jjg at openjdk.java.net
Wed Mar 3 22:27:50 UTC 2021


Please review a fix to improve the handling of the legacy `@exception` tag.

A patch for this was [previously submitted](https://mail.openjdk.java.net/pipermail/javadoc-dev/2019-September/001139.html). However, that patch introduced an explicit new `ExceptionTaglet` class, whereas the fix here just reuses the existing `ThrowsTaglet`, registering it under an additional name.

The test in the original patch is enhanced to check all 4 combinations of (throws, exception) in the base class and (throws, exception) in the subclass.

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

Commit messages:
 - JDK-8157682: @inheritDoc doesn't work with @exception

Changes: https://git.openjdk.java.net/jdk/pull/2818/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=2818&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8157682
  Stats: 131 lines in 2 files changed: 120 ins; 3 del; 8 mod
  Patch: https://git.openjdk.java.net/jdk/pull/2818.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/2818/head:pull/2818

PR: https://git.openjdk.java.net/jdk/pull/2818


More information about the javadoc-dev mailing list