RFR: 8145461 changes to @Deprecated annotation

[David M. Lloyd]

On 03/29/2016 05:38 PM, Stuart Marks wrote:
> Hi all,
>
> Please review these changes to the @Deprecated annotation:
>
>      http://cr.openjdk.java.net/~smarks/reviews/8145461/webrev.0/
>
> This is the first of a set of changes for JEP 277, which I hope will
> become Targeted to JDK 9 late this week. Changes to the deprecation
> status of specific APIs will be in subsequent changesets, along with
> some deprecation tooling.
>
> Note that this is considerably simplified from previous drafts. In
> particular, there is no "reason" enum. See the JEP [1] for background
> and rationale.

Great!

As I said in another forum, I think "condemned" is a bit too obtuse to 
read, linguistically (not to mention humorously ambiguous, as you 
yourself pointed out).  I prefer "plain langauge"; something more like 
"forRemoval" would be better IMO.  Also I agree with Stephen about the 
usefulness of specifying an "until" version, but I understand the 
counterpoints and this could also just as easily be done by a 
third-party library, especially now that JavaDoc is presumably going to 
be much nicer (and thus hopefully more pluggable).

-- 
- DML