changeset 17206:4ecceb2dcc01

8181696: Package versioning link does not exist in JAR file specification Reviewed-by: alanb
author mchung
date Wed, 07 Jun 2017 18:54:45 -0700
parents 67ad6b89dd96
children 0f734ac5ddb1
files src/java.base/share/classes/java/lang/ClassLoader.java src/java.base/share/classes/java/lang/Package.java
diffstat 2 files changed, 6 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/lang/ClassLoader.java	Wed Jun 07 15:05:35 2017 -0400
+++ b/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/src/java.base/share/classes/java/lang/Package.java	Wed Jun 07 15:05:35 2017 -0400
+++ b/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)