make/data/jdwp/jdwp.spec

rev 58770 : [mq]: svc-spec-update

*** 68,78 ****
              (Error VM_DEAD)
          )
      )
      (Command AllClasses=3
          "Returns reference types for all classes currently loaded by the "
!         "target VM."
          (Out
          )
          (Reply
              (Repeat classes "Number of reference types that follow."
                  (Group ClassInfo
--- 68,79 ----
              (Error VM_DEAD)
          )
      )
      (Command AllClasses=3
          "Returns reference types for all classes currently loaded by the "
!         "target VM. "
!         "See <a href=\"../jvmti.html#GetLoadedClasses\">JVM TI GetLoadedClasses</a>."
          (Out
          )
          (Reply
              (Repeat classes "Number of reference types that follow."
                  (Group ClassInfo
*** 598,615 ****
      )
  )
  
  (CommandSet ReferenceType=2
      (Command Signature=1
!         "Returns the JNI signature of a reference type. "
!         "JNI signature formats are described in the "
!         "<a href=\"../jni/index.html\">Java Native Interface Specification</a>"
!         "<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 java.lang.Integer.TYPE."
          (Out
              (referenceType refType "The reference type ID.")
          )
          (Reply
              (string signature
--- 599,611 ----
      )
  )
  
  (CommandSet ReferenceType=2
      (Command Signature=1
!         "Returns the type signature of a reference type. "
!         "Type signature formats are the same as specified in "
!         "<a href=\"../jvmti.html#GetClassSignature\">JVM TI GetClassSignature</a>."
          (Out
              (referenceType refType "The reference type ID.")
          )
          (Reply
              (string signature
*** 2264,2287 ****
          )
      )
  )
  (CommandSet ClassLoaderReference=14
      (Command VisibleClasses=1
!         "Returns a list of all classes which this class loader has "
!         "been requested to load. This class loader is considered to be "
!         "an <i>initiating</i> class loader for each class in the returned "
!         "list. The list contains each "
!         "reference type defined by this loader and any types for which "
          "loading was delegated by this class loader to another class loader. "
          "<p>"
          "The visible class list has useful properties with respect to "
          "the type namespace. A particular type name will occur at most "
          "once in the list. Each field or variable declared with that "
          "type name in a class defined by "
          "this class loader must be resolved to that single type. "
          "<p>"
          "No ordering of the returned list is guaranteed. "
          (Out
              (classLoaderObject classLoaderObject "The class loader object ID. ")
          )
          (Reply
              (Repeat classes "The number of visible classes. "
--- 2260,2300 ----
          )
      )
  )
  (CommandSet ClassLoaderReference=14
      (Command VisibleClasses=1
!         "Returns a list of all classes which this class loader can find "
!         "by name via <code>ClassLoader::loadClass</code>, "
!         "<code>Class::forName</code> and bytecode linkage. That is, "
!         "this class loader has been recorded as an <i>initiating</i> "
!         "loader of the returned classes. The list contains each 
!         "reference type created by this loader and any types for which "
          "loading was delegated by this class loader to another class loader. "
+         "The list does not include hidden classes or interfaces created by "
+         "the invocation of "
+         "<a href=\"../../api/java.base/java/lang/invoke/MethodHandles.Lookup.html#defineHiddenClass(byte[],boolean,java.lang.invoke.MethodHandles.Lookup.ClassOption...)\">Lookup::defineHiddenClass</a> "
+         "because:"
+         "<ul>"
+         "<li>A hidden class or interface cannot be referenced by the "
+         "constant pools of other classes and interfaces.</li>"
+         "<li>A hidden class or interface cannot be discovered by any "
+         "class loader including its defining loader.</li>"
+         "</ul>"
+         "<p>"
+         "In addition, the list does not include array classes whose "
+         "element type is a hidden class or interface as they cannot not discovered "
+         "by any class loader."
          "<p>"
          "The visible class list has useful properties with respect to "
          "the type namespace. A particular type name will occur at most "
          "once in the list. Each field or variable declared with that "
          "type name in a class defined by "
          "this class loader must be resolved to that single type. "
          "<p>"
          "No ordering of the returned list is guaranteed. "
+         "<p>"
+         "See <a href=\"../jvmti.html#GetClassLoaderClasses\">JVM TI GetClassLoaderClasses</a>. "
          (Out
              (classLoaderObject classLoaderObject "The class loader object ID. ")
          )
          (Reply
              (Repeat classes "The number of visible classes. "