src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java

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

*** 1,7 ****
  /*
!  * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 131,152 ****
       * mirroring a type in the target VM with the given name.
       */
      List<ReferenceType> classesByName(String className);
  
      /**
!      * Returns all loaded types. For each loaded type in the target
!      * VM a {@link ReferenceType} will be placed in the returned list.
!      * The list will include ReferenceTypes which mirror classes,
!      * interfaces, and array types.
!      * <P>
!      * The returned list will include reference types
!      * loaded at least to the point of preparation and
!      * types (like array) for which preparation is
!      * not defined.
       *
       * @return a list of {@link ReferenceType} objects, each mirroring
       * a loaded type in the target VM.
       */
      List<ReferenceType> allClasses();
  
      /**
       * All classes given are redefined according to the
--- 131,164 ----
       * mirroring a type in the target VM with the given name.
       */
      List<ReferenceType> classesByName(String className);
  
      /**
!      * Returns all {@linkplain ReferenceType loaded types} in the target VM.
!      * <p>
!      * A class or interface creation can be triggered by one of the following:
!      * <ul>
!      * <li>by loading and deriving a class from a `class` file representation
!      *     using class loader (see JVMS {@jvms 5.3}).
!      * <li>by invoking {@link java.lang.invoke.MethodHandles.Lookup#defineHiddenClass(byte[], boolean, java.lang.invoke.MethodHandles.Lookup.ClassOption...)
!      *     Lookup::defineHiddenClass} that creates a {@link Class#isHidden
!      *     hidden class or interface} from a {@code class} file representation.
!      * <li>by invoking methods in certain Java SE Platform API such as reflection.
!      * </ul>
!      * <p>
!      * An array class is created directly by Java virtual machine.  An array
!      * class creation can be triggered by using class loaders or by invoking
!      * methods in certain Java SE Platform API such as reflection.
!      * <p>
!      * The returned list will include all reference types, including
!      * {@link Class#isHidden hidden classes or interfaces}, loaded
!      * at least to the point of preparation and types (like array)
!      * for which preparation is not defined.
       *
       * @return a list of {@link ReferenceType} objects, each mirroring
       * a loaded type in the target VM.
+      * @jvms 5.3 Creation and Loading
       */
      List<ReferenceType> allClasses();
  
      /**
       * All classes given are redefined according to the