open/src/java.base/share/classes/java/lang/ClassLoader.java

*** 1891,1900 ****
--- 1891,1910 ----
       * If named, the built-in system class loader will have no class path and
       * will search for classes and resources using the application module path;
       * otherwise, if unnamed, it will set the class path to the current
       * working directory.
       *
+      * <p> JAR files on the class path may contain a {@code Class-Path} manifest
+      * attribute to specify dependent JAR files to be included in the class path.
+      * {@code Class-Path} entries must meet certain conditions for validity (see
+      * the <a href="{@docRoot}/../specs/jar/jar.html#class-path-attribute">
+      * JAR File Specification</a> for details).  Invalid {@code Class-Path}
+      * entries are ignored.  For debugging purposes, ignored entries can be
+      * printed to the console if the
+      * {@systemProperty jdk.net.URLClassPath.showIgnoredClassPathEntries} system
+      * property is set to {@code true}.
+      *
       * @return  The system {@code ClassLoader}
       *
       * @throws  SecurityException
       *          If a security manager is present, and the caller's class loader
       *          is not {@code null} and is not the same as or an ancestor of the