--- old/src/java.base/share/classes/java/lang/invoke/MethodHandles.java 2020-04-08 14:54:26.000000000 -0700
+++ new/src/java.base/share/classes/java/lang/invoke/MethodHandles.java 2020-04-08 14:54:25.000000000 -0700
@@ -1808,9 +1808,13 @@
* as the lookup class of this {@code Lookup}.
*
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 + "/" + }, even though
- * this is not a valid binary class or interface name.
+ * ASCII periods. For the instance of {@link java.lang.Class} representing {@code C}:
+ *
+ * - {@link Class#getName()} returns the string {@code GN + "/" + }, even
+ * though this is not a valid binary class or interface name.
+ * - {@link Class#descriptorString()} returns the string {@code "L" + CN + ";" },
+ * even though this is not a valid type descriptor name.
+ *
*
*
*