United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 4318787 stddoclet: Doc inherited from abstr method uses"overrides"instead of"implements"
4318787 : stddoclet: Doc inherited from abstr method uses"overrides"instead of"implements"

Details
Type:
Bug
Submit Date:
2000-03-03
Status:
Closed
Updated Date:
2001-11-22
Project Name:
JDK
Resolved Date:
2001-03-17
Component:
docs
OS:
generic
Sub-Component:
doclet
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.3.0
Fixed Versions:
1.4.0

Related Reports

Sub Tasks

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


                                     
2004-06-14
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
                                     
2001-02-01
PUBLIC COMMENTS

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



Hardware and Software, Engineered to Work Together