A DESCRIPTION OF THE REQUEST :
The @java.lang.Deprecated annotations has no possibility to pass a reason as string.
E.g.:
@Deprecated("Use def() instead, because it is more performant")
public void abc()

JUSTIFICATION :
Currently one places @Deprecated on the e.g. method and writes additionally @deprecated in the javadoc with an explenation and the new method to use.
I think this should be possible to do in one place. So that it is not required to maintain the information in two places.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
see description.
ACTUAL -
see description.