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

Details
Type:
Bug
Submit Date:
2000-03-03
Status:
Closed
Updated Date:
2014-05-05
Project Name:
JDK
Resolved Date:
2001-03-17
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.3.0
Fixed Versions:
1.4.0 (beta)

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
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
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



Hardware and Software, Engineered to Work Together