[JDK9] RFR 8167229: Improve VarHandle documentation

[Alex Buckley]

On 4/28/2017 3:39 PM, Paul Sandoz wrote:
>> On 28 Apr 2017, at 14:55, Alex Buckley <alex.buckley at Oracle.COM> wrote:
>>
>> On 4/26/2017 4:06 PM, Paul Sandoz wrote:
>>> Please review some documentation changes to VarHandle:
>>>
>>> http://cr.openjdk.java.net/~psandoz/jdk9/JDK-8167229-varhandle-docs/webrev/index.html
>>
>> I notice that "shape" is still mentioned throughout the MethodHandles.Lookup class.
>>
>
> Are you looking at the old version? I removed ‘em all from the new version.

Ah sorry, I forgot to look at Lookup within the MethodHandles.java 
webrev. All looks good.

>> BTW Since "array elements" are mentioned in the opening paragraph, and since here is an example involving String[] as a coordinate type later, it would be nice to say how a VarHandle pointing to an array element can be created.
>
> Ok.

This is a nice and surprisingly compact example.

Alex