hg: jdk9/sandbox/jdk: Updates to documentation from review comments.

[paul.sandoz at oracle.com]

Changeset: f0820540d97f
Author:    psandoz
Date:      2016-02-08 17:40 +0100
URL:       http://hg.openjdk.java.net/jdk9/sandbox/jdk/rev/f0820540d97f

Updates to documentation from review comments.

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