Annotation Type Documented
@Documented @Retention(RUNTIME) @Target(ANNOTATION_TYPE) public @interface Documented
If the annotation @Documented
is present on the declaration of an annotation type A, then any @A
annotation on an element is considered part of the element's public contract. In more detail, when an annotation type A is annotated with Documented
, the presence and value of annotations of type A are a part of the public contract of the elements A annotates. Conversely, if an annotation type B is not annotated with Documented
, the presence and value of B annotations are not part of the public contract of the elements B annotates. Concretely, if an annotation type is annotated with
Documented
, by default a tool like javadoc will display annotations of that type in its output while annotations of annotation types without Documented
will not be displayed.
- Since:
- 1.5