hg: amber/amber: adding some clarifications to the API

[vicente.romero at oracle.com]

Changeset: 6d0439b38280
Author:    vromero
Date:      2018-11-13 08:27 -0500
URL:       http://hg.openjdk.java.net/amber/amber/rev/6d0439b38280

adding some clarifications to the API

! src/java.base/share/classes/java/lang/constant/ClassDesc.java
! src/java.base/share/classes/java/lang/constant/DirectMethodHandleDesc.java
! src/java.base/share/classes/java/lang/constant/MethodTypeDesc.java