Remove bad comment refactoring and add description for use of internal name on elements that do not define an internal name according to the documentation.

Author: raphw

byte-buddy-dep/src/main/java/net/bytebuddy/description/NamedElement.java

@@ -31,7 +31,7 @@ public interface NamedElement {
     String EMPTY_NAME = "";
 
     /**
-     * Returns the name of this element as it is found in the source code. If no such name exists,
+     * Returns the display name of this element as it is found in the source code. If no such name exists,
      * an empty string is returned.
      *
      * @return The name of this element as given in a Java program's source code.
@@ -44,16 +44,18 @@ public interface NamedElement {
     interface WithRuntimeName extends NamedElement {
 
         /**
-         * Returns the internalName of this byte code element.
+         * Returns the binary name of this byte code element. If no well-defined internal name is known for this element,
+         * the actual name is returned.
          *
-         * @return The internalName of this byte code element as visible from within a running Java application.
+         * @return The binary ame of this byte code element as visible from within a running Java application.
          */
         String getName();
 
         /**
-         * Returns the internal internalName of this byte code element.
+         * Returns the internal name of this byte code element. If no well-defined internal name is known for this element,
+         * the actual name is returned.
          *
-         * @return The internal internalName of this byte code element as used within the Java class file format.
+         * @return The internal name of this byte code element as used within the Java class file format.
          */
         String getInternalName();
     }

byte-buddy-dep/src/main/java/net/bytebuddy/description/type/TypeDescription.java

@@ -228,9 +228,9 @@ public interface TypeDescription extends TypeDefinition, ByteCodeElement, TypeVa
     int getActualModifiers(boolean superFlag);
 
     /**
-     * Returns the simple internalName of this type.
+     * Returns the simple name of this type.
      *
-     * @return The simple internalName of this type.
+     * @return The simple name of this type.
      */
     String getSimpleName();
 

byte-buddy-dep/src/main/java/net/bytebuddy/implementation/bind/MethodNameEqualityResolver.java

@@ -20,7 +20,7 @@
 /**
  * Implementation of an
  * {@link net.bytebuddy.implementation.bind.MethodDelegationBinder.AmbiguityResolver}
- * that resolves conflicting bindings by considering equality of a target method's internalName as an indicator for a dominant
+ * that resolves conflicting bindings by considering equality of a target method's name as an indicator for a dominant
  * binding.
  * <p>&nbsp;</p>
  * For example, if method {@code source.foo} can be bound to methods {@code targetA.foo} and {@code targetB.bar},