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

[Peter Levart]

Hi Aleksey,

What's not very clear is whether the class-level @Contended is the same 
as class-level @Contended("group") - is the tag used or ignored when 
specified on the class-level. What does the following do?

@Contended("x")
class C {
    @Contended("x") int a;
    @Contended("y") int b;
    int c;
}


Regards, Peter


On 05/23/2013 06:16 PM, Aleksey Shipilev wrote:
> On 05/23/2013 07:57 PM, Peter Levart wrote:
>> Have I understood this correctly?
> Yes. @Contended on class is currently the shorthand for the @Contended
> with the same (but unknown) tag over all the fields. However, in future
> this might change, because @Contended on class might also guard the
> object header, as soon as we are brave enough to tap into the GC
> interface to allocate the @C objects aligned for the cache line boundary.
>
> -Aleksey.