--- old/src/jdk.jdi/share/classes/com/sun/jdi/Type.java	2020-04-13 21:04:02.000000000 -0700
+++ new/src/jdk.jdi/share/classes/com/sun/jdi/Type.java	2020-04-13 21:04:02.000000000 -0700
@@ -138,20 +138,22 @@
 public interface Type extends Mirror {
 
     /**
-     * Returns the JNI-style signature for this type.
-     * <p>
-     * For primitive classes
-     * the returned signature is the signature of the corresponding primitive
-     * type; for example, "I" is returned as the signature of the class
-     * represented by {@link java.lang.Integer#TYPE}.
+     * Returns the type signature for this type.  The result is of the same
+     * form as the descriptor string returned by {@link Class#descriptorString()}.
+     * The returned string may not be a valid type descriptor.
      *
-     * @see <a href="doc-files/signature.html">Type Signatures</a>
-     * @return the string containing the type signature.
+     * @see java.lang.invoke.TypeDescriptor#descriptorString()
+     * @return the type signature
      */
     String signature();
 
     /**
-     * @return a text representation of this type.
+     * Returns the name of this type. The result is of the same form as
+     * the name returned by {@link Class#getName()}.
+     * The returned name may not be a binary name.
+     * 
+     * @see Class#getName()
+     * @return the name of this type
      */
     String name();
 }