Loading...

XML

Word

Printable

Type: Bug
Resolution: Unresolved
Priority: P4
Fix Version/s: tbd
Affects Version/s: 20
Component/s: tools
Labels:
None

Subcomponent:
javadoc(tool)

A "simple override" is a JavaDoc lingo for an overriding method that does not change the spec provided by the overridden method in any way.

Currently, "simple overrides" are both underdetected and detected incorrectly. Underdetection (i.e. a false negative) happens when one or more inheritable block tags consist of `{@inheritDoc}`. Incorrect detection happens when omitted `@throws X {@inheritDoc}` tags are assumed to be inherited, which they are not, unless `X` is listed in the `throws` clause.

blocks

JDK-8287796 Stop auto-inheriting documentation for subclasses of exceptions whose documentation is inherited

Resolved

is blocked by

JDK-8291869 Match exceptions using types of javax.lang.model, not strings

Resolved

relates to

JDK-8296607 Review and specify no-spec-change overrides

Open

JDK-8294377 Prepare to stop auto-inheriting documentation for subclasses of exceptions whose documentation is inherited

Resolved

JDK-8187386 Do not generate javadoc for overridden method with no spec change

Closed

Assignee:: Unassigned

Reporter:: Pavel Rappo (Inactive)

Votes:: 0 Vote for this issue

Watchers:: 1 Start watching this issue

Created:: 2022-08-03 04:18

Updated:: 2025-01-15 13:25

Details

Description

Attachments

Issue Links

Activity

People

Dates