8181696: Package versioning link does not exist in JAR file specification
authormchung
Wed, 07 Jun 2017 18:54:45 -0700
changeset 45527 09cded555a99
parent 45526 45a0ee4c1978
child 45528 1e8c2f062ad3
8181696: Package versioning link does not exist in JAR file specification Reviewed-by: alanb
jdk/src/java.base/share/classes/java/lang/ClassLoader.java
jdk/src/java.base/share/classes/java/lang/Package.java
--- a/jdk/src/java.base/share/classes/java/lang/ClassLoader.java	Wed Jun 07 15:05:35 2017 -0400
+++ b/jdk/src/java.base/share/classes/java/lang/ClassLoader.java	Wed Jun 07 18:54:45 2017 -0700
@@ -2146,8 +2146,6 @@
      * @revised 9
      * @spec JPMS
      *
-     * @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>
      */
--- a/jdk/src/java.base/share/classes/java/lang/Package.java	Wed Jun 07 15:05:35 2017 -0400
+++ b/jdk/src/java.base/share/classes/java/lang/Package.java	Wed Jun 07 18:54:45 2017 -0700
@@ -102,9 +102,13 @@
  * 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#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)