changeset 17245:51f5d60713b5

8182023: some java.util.jar docs contain links to technotes Reviewed-by: mchung Contributed-by: brent.christian@oracle.com, paul.sandoz@oracle.com
author psandoz
date Tue, 20 Jun 2017 08:52:24 -0700
parents 79db2bd40baf
children b252dd92a359
files src/java.base/share/classes/java/lang/ClassLoader.java src/java.base/share/classes/java/lang/Package.java src/java.base/share/classes/java/util/jar/Attributes.java src/java.base/share/classes/java/util/jar/Manifest.java src/java.base/share/classes/java/util/jar/package-info.java src/java.management/share/classes/javax/management/remote/JMXConnectorFactory.java src/java.management/share/classes/javax/management/remote/JMXConnectorServerFactory.java
diffstat 7 files changed, 16 insertions(+), 18 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/lang/ClassLoader.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.base/share/classes/java/lang/ClassLoader.java	Tue Jun 20 08:52:24 2017 -0700
@@ -2165,7 +2165,7 @@
      * @revised 9
      * @spec JPMS
      *
-     * @see <a href="../../../technotes/guides/jar/jar.html#sealing">
+     * @see <a href="{@docRoot}/../specs/jar/jar.html#sealing">
      *      The JAR File Specification: Package Sealing</a>
      */
     protected Package definePackage(String name, String specTitle,
--- a/src/java.base/share/classes/java/lang/Package.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.base/share/classes/java/lang/Package.java	Tue Jun 20 08:52:24 2017 -0700
@@ -109,7 +109,7 @@
  * and have no specification and implementation versioning information.
  *
  * @jvms 5.3 Run-time package
- * @see <a href="../../../technotes/guides/jar/jar.html#sealing">
+ * @see <a href="{@docRoot}/../specs/jar/jar.html#sealing">
  * The JAR File Specification: Package Sealing</a>
  * @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)
  *
--- a/src/java.base/share/classes/java/util/jar/Attributes.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.base/share/classes/java/util/jar/Attributes.java	Tue Jun 20 08:52:24 2017 -0700
@@ -44,7 +44,7 @@
  * the ASCII characters in the set [0-9a-zA-Z_-], and cannot exceed 70
  * characters in length. Attribute values can contain any characters and
  * will be UTF8-encoded when written to the output stream.  See the
- * <a href="../../../../technotes/guides/jar/jar.html">JAR File Specification</a>
+ * <a href="{@docRoot}/../specs/jar/jar.html">JAR File Specification</a>
  * for more information about valid attribute names and values.
  *
  * <p>This map and its views have a predictable iteration order, namely the
@@ -443,7 +443,7 @@
      * to the ASCII characters in the set [0-9a-zA-Z_-], and cannot exceed
      * 70 characters in length. Attribute values can contain any characters
      * and will be UTF8-encoded when written to the output stream.  See the
-     * <a href="../../../../technotes/guides/jar/jar.html">JAR File Specification</a>
+     * <a href="{@docRoot}/../specs/jar/jar.html">JAR File Specification</a>
      * for more information about valid attribute names and values.
      */
     public static class Name {
@@ -529,7 +529,7 @@
          * {@code Name} object for {@code Manifest-Version}
          * manifest attribute. This attribute indicates the version number
          * of the manifest standard to which a JAR file's manifest conforms.
-         * @see <a href="../../../../technotes/guides/jar/jar.html#JAR_Manifest">
+         * @see <a href="{@docRoot}/../specs/jar/jar.html#JAR_Manifest">
          *      Manifest and Signature Specification</a>
          */
         public static final Name MANIFEST_VERSION = new Name("Manifest-Version");
@@ -537,7 +537,7 @@
         /**
          * {@code Name} object for {@code Signature-Version}
          * manifest attribute used when signing JAR files.
-         * @see <a href="../../../../technotes/guides/jar/jar.html#JAR_Manifest">
+         * @see <a href="{@docRoot}/../specs/jar/jar.html#JAR_Manifest">
          *      Manifest and Signature Specification</a>
          */
         public static final Name SIGNATURE_VERSION = new Name("Signature-Version");
@@ -551,7 +551,7 @@
         /**
          * {@code Name} object for {@code Class-Path}
          * manifest attribute.
-         * @see <a href="../../../../technotes/guides/jar/jar.html#classpath">
+         * @see <a href="{@docRoot}/../specs/jar/jar.html#classpath">
          *      JAR file specification</a>
          */
         public static final Name CLASS_PATH = new Name("Class-Path");
@@ -568,7 +568,7 @@
         /**
          * {@code Name} object for {@code Sealed} manifest attribute
          * used for sealing.
-         * @see <a href="../../../../technotes/guides/jar/jar.html#sealing">
+         * @see <a href="{@docRoot}/../specs/jar/jar.html#sealing">
          *      Package Sealing</a>
          */
         public static final Name SEALED = new Name("Sealed");
--- a/src/java.base/share/classes/java/util/jar/Manifest.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.base/share/classes/java/util/jar/Manifest.java	Tue Jun 20 08:52:24 2017 -0700
@@ -39,7 +39,7 @@
  * associated Attributes. There are main Manifest Attributes as well as
  * per-entry Attributes. For information on the Manifest format, please
  * see the
- * <a href="../../../../technotes/guides/jar/jar.html">
+ * <a href="{@docRoot}/../specs/jar/jar.html">
  * Manifest format specification</a>.
  *
  * @author  David Connelly
--- a/src/java.base/share/classes/java/util/jar/package-info.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.base/share/classes/java/util/jar/package-info.java	Tue Jun 20 08:52:24 2017 -0700
@@ -40,7 +40,7 @@
  *       <a href="../zip/package-summary.html#package_description">java.util.zip
  *       package description.</a> <p>
  *       In JAR files, all file names must be encoded in the UTF-8 encoding.
- *   <li><a href="../../../../technotes/guides/jar/jar.html">
+ *   <li><a href="{@docRoot}/../specs/jar/jar.html">
  *       Manifest and Signature Specification</a> - The manifest format specification.
  * </ul>
  *
--- a/src/java.management/share/classes/javax/management/remote/JMXConnectorFactory.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.management/share/classes/javax/management/remote/JMXConnectorFactory.java	Tue Jun 20 08:52:24 2017 -0700
@@ -136,10 +136,9 @@
  * <code><em>protocol</em></code>, or it will throw a
  * <code>MalformedURLException</code> if there is none.  An
  * implementation may choose to find providers by other means.  For
- * example, it may support the <a
- * href="{@docRoot}/../technotes/guides/jar/jar.html#Service%20Provider">
- * JAR conventions for service providers</a>, where the service
- * interface is <code>JMXConnectorProvider</code>.</p>
+ * example, it may support <a
+ * href="{@docRoot}/../java/util/ServiceLoader.html#developing-service-providers">service providers</a>,
+ * where the service interface is <code>JMXConnectorProvider</code>.</p>
  *
  * <p>Every implementation must support the RMI connector protocol with
  * the default RMI transport, specified with string <code>rmi</code>.
--- a/src/java.management/share/classes/javax/management/remote/JMXConnectorServerFactory.java	Tue Jun 20 08:42:18 2017 -0700
+++ b/src/java.management/share/classes/javax/management/remote/JMXConnectorServerFactory.java	Tue Jun 20 08:52:24 2017 -0700
@@ -127,10 +127,9 @@
  * <code><em>protocol</em></code>, or it will throw a
  * <code>MalformedURLException</code> if there is none.  An
  * implementation may choose to find providers by other means.  For
- * example, it may support the <a
- * href="{@docRoot}/../technotes/guides/jar/jar.html#Service%20Provider">
- * JAR conventions for service providers</a>, where the service
- * interface is <code>JMXConnectorServerProvider</code>.</p>
+ * example, it may support <a
+ * href="{@docRoot}/../java/util/ServiceLoader.html#developing-service-providers">service providers</a>,
+ * where the service interface is <code>JMXConnectorServerProvider</code>.</p>
  *
  * <p>Every implementation must support the RMI connector protocol with
  * the default RMI transport, specified with string <code>rmi</code>.