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

@@ -1806,13 +1806,17 @@
          * {@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" + CN + ";" },
+         *      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.