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.
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 :
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()"