[JSR308] Annotations in Javadoc

[Michael Ernst]

Thanks for the info about Javadoc!
The details about Javadoc an annotations can be found at
  http://java.sun.com/javase/6/docs/api/java/lang/annotation/Documented.html

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.

                    -Mike