RFR (S) CR 8014966: Add the proper Javadoc to @Contended

[Aleksey Shipilev]

Hi David,

On 05/28/2013 04:11 AM, David Holmes wrote:
> Okay I have some suggested rewordings below and a couple of grammatical
> corrections.

Thank you! The updated webrev is here:
  http://cr.openjdk.java.net/~shade/8014966/webrev.02/

Changes from the David's version:
  * added the provisioning for isolation from superclass as well: "The
effects of all {@code @Contended} annotations, however, remain in force
for all >>>> superclass and <<<< subclass instances, providing isolation
of all the defined contention groups."
  * minor touchups to make doclint happy.

I think we are ready to go. Objections, comments, more RFCs?

-Aleksey.