This is a good improvement. I agree that David Holmes is your possible best
reviewer. :-)
Mike
On May 23 2013, at 09:47 , Aleksey Shipilev wrote:
> Ummm... I think that's exactly what the last paragraph says. What if we
> rephrase it as follows?
>
> ------------- 8< -----------------------------------------------
> When the annotation is used at the class level, the effect is
> roughly equivalent to placing the {@code @Contended} annotation
> with the anonymous tag over all the unannotated fields of the
> object. With the class level annotation, the implementations may
> choose different approach to protect the entire object, rather
> than protecting only the distinct fields.
> ------------- 8< -----------------------------------------------
>
> -Aleksey.
>
> On 05/23/2013 08:20 PM, Mike Duigou wrote:
>> You could add one more sentence to cover the effect of @C on class
>> with no @C on any field. The response to Peter is great info (but too
>> much detail for JavaDoc).
>>
>> Mike
>>
>> On May 23 2013, at 09:17 , Aleksey Shipilev wrote:
>>
>>> On 05/23/2013 06:33 PM, Mike Duigou wrote:
>>>> A class level annotation on a class containing no annotated
>>>> fields has no effect, correct?
>>>
>>> It does have the effect, see the last paragraph in the Javadoc.
>>> Should we refine this a bit?
>>>
>>> -Aleksey.
>>
>
