[JDK9] RFR 8167229: Improve VarHandle documentation

[Martin Buchholz]

Oh wait, there's a distinction between "access mode" and "access mode
method", because of VarHandle.AccessMode.

Is it true that each access mode is associated with exactly one access mode
method ?  Seems to be yes, because of
http://download.java.net/java/jdk9/docs/api/java/lang/invoke/VarHandle.AccessMode.html#methodName--


It might be worth making that clearer somehow.

<p>Each access mode is associated with one <em>access mode method</em>

On Thu, Apr 27, 2017 at 10:20 AM, Martin Buchholz <martinrb at google.com>
wrote:

>
> <p>Each access mode is associated with an <em>access mode method</em>
>
> Tautological.  Did you mean to say "Each VarHandle method" or "Each
> access" ?
>
>
>>   http://cr.openjdk.java.net/~psandoz/jdk9/JDK-8167229-varhand
>> le-docs/webrev/index.html
>>
>