--- 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)