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

rev 58768 : 8238358: Implementation of JEP 371: Hidden Classes
Reviewed-by: alanb, cjplummer, coleenp, dholmes, dlong, forax, jlahoda, psandoz, plevart, vromero
Contributed-by: mandy.chung@oracle.com, lois.foltan@oracle.com, david.holmes@oracle.com, harold.seigel@oracle.com, serguei.spitsyn@oracle.com, alex.buckley@oracle.com, jamsheed.c.m@oracle.com, jan.lahoda@oracle.com, amy.lu@oracle.com
rev 58769 : imported patch type-descriptor-name

@@ -1806,13 +1806,18 @@
          * {@linkplain Class#getPackage() package}, {@linkplain Class#getModule() module}
          * and {@linkplain java.security.ProtectionDomain protection domain}
          * as the lookup class of this {@code Lookup}.
          * <li> Let {@code GN} be the binary name obtained by taking {@code N}
          * (a binary name encoded in internal form) and replacing ASCII forward slashes with
-         * ASCII periods. For the instance of {@link java.lang.Class} representing {@code C},
-         * {@link Class#getName()} returns the string {@code GN + "/" + <suffix>}, even though
-         * this is not a valid binary class or interface name.</li>
+         * ASCII periods. For the instance of {@link java.lang.Class} representing {@code C}:
+         * <ul>
+         * <li> {@link Class#getName()} returns the string {@code GN + "/" + <suffix>},
+         *      even though this is not a valid binary class or interface name.</li>
+         * <li> {@link Class#descriptorString()} returns the string
+         *      {@code "L" + N + ";" + "/" + <suffix> },
+         *      even though this is not a valid type descriptor name.</li>
+         * </ul>
          * </ul>
          * </li>
          * </ol>
          *
          * <p> After {@code C} is derived, it is linked by the Java Virtual Machine.