src/java.base/share/classes/java/lang/Package.java

*** 100,112 ****
   * ClassLoader.getDefinedPackage(String)} methods.
   * Every {@code Package} defined by a class loader can be obtained
   * with the {@link Package#getPackages Package.getPackages()} and
   * {@link ClassLoader#getDefinedPackages} methods.
   *
   * @jvms 5.3 Run-time package
-  * @see <a href="../../../technotes/guides/jar/jar.html#versioning">
-  * The JAR File Specification: Package Versioning</a>
   * @see <a href="../../../technotes/guides/jar/jar.html#sealing">
   * The JAR File Specification: Package Sealing</a>
   * @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)
   *
   * @since 1.2
--- 100,116 ----
   * ClassLoader.getDefinedPackage(String)} methods.
   * Every {@code Package} defined by a class loader can be obtained
   * with the {@link Package#getPackages Package.getPackages()} and
   * {@link ClassLoader#getDefinedPackages} methods.
   *
+  * @implNote
+  * The <a href="ClassLoader.html#builtinLoaders">builtin class loaders</a>
+  * do not explicitly define {@code Package} objects for packages in
+  * <em>named modules</em>.  Instead those packages are automatically defined
+  * and have no specification and implementation versioning information.
+  *
   * @jvms 5.3 Run-time package
   * @see <a href="../../../technotes/guides/jar/jar.html#sealing">
   * The JAR File Specification: Package Sealing</a>
   * @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)
   *
   * @since 1.2