Deprecation should be marked with both the ``++@Deprecated++`` annotation and @deprecated Javadoc tag. The annotation enables tools such as IDEs to warn about referencing deprecated elements, and the tag can be used to explain when it was deprecated, why, and how references should be refactored. 


Further, Java 9 adds two additional arguments to the annotation:

* ``++since++`` allows you to describe when the deprecation took place
* ``++forRemoval++``, indicates whether the deprecated element will be removed at some future date

If your compile level is Java 9 or higher, you should be using one or both of these arguments.
