hg: jdk9/dev/jdk: 8167229: Improve VarHandle documentation

[paul.sandoz at oracle.com]

Changeset: b3601980b5b2
Author:    psandoz
Date:      2017-05-01 11:16 -0700
URL:       http://hg.openjdk.java.net/jdk9/dev/jdk/rev/b3601980b5b2

8167229: Improve VarHandle documentation
Reviewed-by: martin, abuckley

! src/java.base/share/classes/java/lang/invoke/MethodHandles.java
! src/java.base/share/classes/java/lang/invoke/VarHandle.java