--- old/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java	2020-04-12 17:30:12.000000000 -0700
+++ new/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java	2020-04-12 17:30:12.000000000 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
+ * 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
@@ -133,18 +133,30 @@
     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.
+     * 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();