[JSR308] Annotations in Javadoc

Michael Ernst mernst at csail.mit.edu
Sat May 19 17:07:55 EDT 2007

Thanks for the info about Javadoc!
The details about Javadoc an annotations can be found at

That states that annotations that are meta-annotated with @Documented "are
documented by javadoc and similar tools by default".  Does anyone know what
"by default" means in that phrase?  How does one override the default?

I raised this issue because some individuals have expressed concern that
too many annotations may clutter source code.  Similar clutter-reduction
ideas may need to be applied to Javadoc, but that is an issue for JSR 260
and JSR 305 to work out together.


More information about the JSR308 mailing list