8278863: Add method ClassDesc::ofInternalName

src/java.base/share/classes/java/lang/constant/ClassDesc.java

@@ -72,6 +72,8 @@ public sealed interface ClassDesc
      * @throws NullPointerException if the argument is {@code null}
      * @throws IllegalArgumentException if the name string is not in the
      * correct format
+     * @see ClassDesc#ofDescriptor(String)
+     * @see ClassDesc#ofInternalName(String)
      */
     static ClassDesc of(String name) {
         ConstantUtils.validateBinaryClassName(requireNonNull(name));
@@ -82,17 +84,21 @@ static ClassDesc of(String name) {
      * Returns a {@linkplain ClassDesc} for a class or interface type,
      * given the name of the class or interface in internal form,
      * such as {@code "java/lang/String"}.
-     * (To create a descriptor for an array type, either use {@link #ofDescriptor(String)}
+     *
+     * @apiNote
+     * To create a descriptor for an array type, either use {@link #ofDescriptor(String)}
      * or {@link #arrayType()}; to create a descriptor for a primitive type, use
      * {@link #ofDescriptor(String)} or use the predefined constants in
-     * {@link ConstantDescs}).
+     * {@link ConstantDescs}.
      *
      * @param name the fully qualified class name, in internal (slash-separated) form
      * @return a {@linkplain ClassDesc} describing the desired class
      * @throws NullPointerException if the argument is {@code null}
      * @throws IllegalArgumentException if the name string is not in the
      * correct format
      * @jvms 4.2.1 Binary Class and Interface Names
+     * @see ClassDesc#of(String)
+     * @see ClassDesc#ofDescriptor(String)
      */
     static ClassDesc ofInternalName(String name) {
         ConstantUtils.validateInternalClassName(requireNonNull(name));
@@ -146,6 +152,8 @@ static ClassDesc of(String packageName, String className) {
      * correct format
      * @jvms 4.3.2 Field Descriptors
      * @jvms 4.4.1 The CONSTANT_Class_info Structure
+     * @see ClassDesc#of(String)
+     * @see ClassDesc#ofInternalName(String)
      */
     static ClassDesc ofDescriptor(String descriptor) {
         requireNonNull(descriptor);