A DESCRIPTION OF THE REQUEST :
There needs to be an annotation (possibly one that generates warnings) so that Sun can represent classes that have been replaced by better options, but haven't deprecated.

EG: StringTokenizer has been denigrated in favour of RegEx.

JUSTIFICATION :
I believe that bugs filed against some features almost never get fixed, because they've been replaced by other more functional pieces. This would allow developers to know that there's a better way to do something.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
A simple warning at compile time that this class has been replaced by something else:

"Denigration warning: Use of StringTokenizer should be replaced by a use of Pattern.matches()"