8181696: Package versioning link does not exist in JAR file specification
Reviewed-by: alanb
--- 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)