Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4318787

stddoclet: Doc inherited from abstr method uses"overrides"instead of"implements"

XMLWordPrintable

    • beta
    • generic
    • generic
    • Verified

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

            jhosunw Jamie Ho (Inactive)
            nlindenbsunw Norbert Lindenberg (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: