Java in a Nutshell, 5th Edition [Electronic resources] نسخه متنی

This annotation
type marks the annotated program element as deprecated. The Java
compiler issues a warning if the annotated element is used or
overrided in code that is not itself @Deprecated.

In Java 5.0,
the @Deprecated annotation works in the same way as
the @deprecated javadoc tag. In future releases of
Java, the compiler may ignore @deprecated javadoc
tag and rely only on the @Deprecated annotation.

This annotation type has source retention and does not have an
@Target meta-annotation, which means it may be
applied to any program element. Deprecated has an
@Documented meta-annotation, meaning that the
presence of an @Deprecated annotation should be a
documented part of the annotated element's API.

Figure 10-16. java.lang.Deprecated

public @interface

Deprecated {
}