JDK-6586965 : Request of formal documentation about Override annotation
  • Type: Enhancement
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 6u1
  • Priority: P4
  • Status: Closed
  • Resolution: Not an Issue
  • OS: generic
  • CPU: generic
  • Submitted: 2007-07-30
  • Updated: 2010-05-09
  • Resolved: 2007-11-27
Related Reports
Relates :  
JDK-6501053 - Specification of java.lang.Override was not updated when integrating 6399361
Description
Discussion on the web seems to indicate that users are making guesses
about @Override's portability because there doesn't seem to be any
formal documentation from Sun. I would suggest that Sun formally
document that this feature was added as of JDK 6, in the release notes
as well as in the javadoc of the Override annotation.
Comments
EVALUATION The annotation is documented in the API specification: http://java.sun.com/javase/6/docs/api/java/lang/Override.html as well as the JLSv3: http://java.sun.com/docs/books/jls/third_edition/html/interfaces.html#9.6.1.4 A change in how @Override can be applied was omitted from JDK 6 (bug 6501053). The corrected description appears in the bug and in JDK 7.
27-11-2007