P5
A DESCRIPTION OF THE PROBLEM :
The Annotation Processing Tool (apt) documentation page in the JDK Documentation should mention the new annotation processing API introduced in Java SE 6. That is the direct support for annotation processors provided by javac and the related packages javax.annotation and javax.annotation.processing.
Otherwise, developers might be confused. It's really difficult to discover those enhancements if you already know apt from J2SE 5.0. Also, if you don't know apt before you will probably use it and not javac due to the lack of information.
URL OF FAULTY DOCUMENTATION :
http://download.java.net/jdk6/docs/technotes/guides/apt/index.html
The Annotation Processing Tool (apt) documentation page in the JDK Documentation should mention the new annotation processing API introduced in Java SE 6. That is the direct support for annotation processors provided by javac and the related packages javax.annotation and javax.annotation.processing.
Otherwise, developers might be confused. It's really difficult to discover those enhancements if you already know apt from J2SE 5.0. Also, if you don't know apt before you will probably use it and not javac due to the lack of information.
URL OF FAULTY DOCUMENTATION :
http://download.java.net/jdk6/docs/technotes/guides/apt/index.html