--- old/src/java.base/share/classes/java/lang/ClassLoader.java 2017-06-06 11:12:47.000000000 -0700 +++ new/src/java.base/share/classes/java/lang/ClassLoader.java 2017-06-06 11:12:47.000000000 -0700 @@ -2146,8 +2146,6 @@ * @revised 9 * @spec JPMS * - * @see - * The JAR File Specification: Package Versioning * @see * The JAR File Specification: Package Sealing */ --- old/src/java.base/share/classes/java/lang/Package.java 2017-06-06 11:12:47.000000000 -0700 +++ new/src/java.base/share/classes/java/lang/Package.java 2017-06-06 11:12:47.000000000 -0700 @@ -102,9 +102,13 @@ * with the {@link Package#getPackages Package.getPackages()} and * {@link ClassLoader#getDefinedPackages} methods. * + * @implNote + * The builtin class loaders + * do not explicitly define {@code Package} objects for packages in + * named modules. Instead those packages are automatically defined + * and have no specification and implementation versioning information. + * * @jvms 5.3 Run-time package - * @see - * The JAR File Specification: Package Versioning * @see * The JAR File Specification: Package Sealing * @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)