--- old/src/java.base/share/classes/java/lang/invoke/MethodHandles.java	2020-04-13 21:03:52.000000000 -0700
+++ new/src/java.base/share/classes/java/lang/invoke/MethodHandles.java	2020-04-13 21:03:52.000000000 -0700
@@ -1808,9 +1808,14 @@
          * 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>