RFR: 8145461 changes to @Deprecated annotation

[Stuart Marks]

On 4/1/16 6:06 AM, Stephen Colebourne wrote:
> My only (very minor) comment now is that it makes more logical sense
> for the since() method to precede the forRemoval() method in the
> source code (as since will be applied before forRemoval).

Yes, this is quite sensible. The source code order also determines the order in 
the javadoc output. I'll change this, and I'll also swap the corresponding 
paragraphs in the class spec.

Thanks,

s'marks