JDK-4318787 : stddoclet: Doc inherited from abstr method uses"overrides"instead of"implements"
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.3.0
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2000-03-03
  • Updated: 2020-08-31
  • Resolved: 2001-03-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.0 betaFixed
Description
When inheriting documentation from an abstract method in an abstract class (not an interface), javadoc produces text saying that the implementation "overrides" the abstract method. The specification for re-use of method comments in the javadoc documentation ignores the case of abstract methods, but the usage is certainly not consistent with the definition of "overrides" and "implements" in the Java Language Specification, section 6.4.2. According to that definition, the correct term to use is "implements".

See http://java.sun.com/products/jdk/1.2/docs/api/java/util/PropertyResourceBundle.html#handleGetObject(java.lang.String) for an example (yes, the description taken from the source file has the same bug...).

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: merlin-beta FIXED IN: merlin-beta INTEGRATED IN: merlin-beta VERIFIED IN: merlin-rc1
14-06-2004

EVALUATION This bug has been fixed. If a method implements an abstract method, it is documented appropriately. Location of Fix: MethodSubWriter.printOverridden() jamie.ho@Eng 2001-02-01 Easy fix. Just change a string. doug.kramer@Eng 2000-09-07
01-02-2001

PUBLIC COMMENTS This bug has been fixed. If a method implements an abstract method, it is documented appropriately. jamie.ho@Eng 2001-02-01
01-02-2001