JDK 11 RFR of JDK-8205003: Replace selected link tags with linkplain in java.lang.Class

joe darcy joe.darcy at oracle.com
Thu Jun 14 00:51:13 UTC 2018


Hello,

Please review the small patch below to address

     JDK-8205003: Replace selected link tags with linkplain in 
java.lang.Class

Thanks,

-Joe

diff -r 0742a087710e src/java.base/share/classes/java/lang/Class.java
--- a/src/java.base/share/classes/java/lang/Class.java    Wed Jun 13 
13:12:50 2018 -0700
+++ b/src/java.base/share/classes/java/lang/Class.java    Wed Jun 13 
17:50:12 2018 -0700
@@ -820,7 +820,7 @@
       * primitive type or void, then the {@code Module} object for the
       * {@code java.base} module is returned.
       *
-     * If this class is in an unnamed module then the {@link
+     * If this class is in an unnamed module then the {@linkplain
       * ClassLoader#getUnnamedModule() unnamed} {@code Module} of the class
       * loader for this class is returned.
       *
@@ -953,14 +953,14 @@
       * empty string if the class is in an unnamed package.
       *
       * <p> If this class is a member class, then this method is 
equivalent to
-     * invoking {@code getPackageName()} on the {@link #getEnclosingClass
+     * invoking {@code getPackageName()} on the {@linkplain 
#getEnclosingClass
       * enclosing class}.
       *
-     * <p> If this class is a {@link #isLocalClass local class} or an 
{@link
+     * <p> If this class is a {@linkplain #isLocalClass local class} or 
an {@linkplain
       * #isAnonymousClass() anonymous class}, then this method is 
equivalent to
-     * invoking {@code getPackageName()} on the {@link #getDeclaringClass
-     * declaring class} of the {@link #getEnclosingMethod enclosing 
method} or
-     * {@link #getEnclosingConstructor enclosing constructor}.
+     * invoking {@code getPackageName()} on the {@linkplain 
#getDeclaringClass
+     * declaring class} of the {@linkplain #getEnclosingMethod 
enclosing method} or
+     * {@linkplain #getEnclosingConstructor enclosing constructor}.
       *
       * <p> If this class represents an array type then this method 
returns the
       * package name of the element type. If this class represents a 
primitive
@@ -2576,7 +2576,7 @@
       * @param  name name of the desired resource
       * @return  A {@link java.io.InputStream} object; {@code null} if no
       *          resource with this name is found, the resource is in a 
package
-     *          that is not {@link Module#isOpen(String, Module) open} 
to at
+     *          that is not {@linkplain Module#isOpen(String, Module) 
open} to at
       *          least the caller module, or access to the resource is 
denied
       *          by the security manager.
       * @throws  NullPointerException If {@code name} is {@code null}
@@ -2675,7 +2675,7 @@
       * @return A {@link java.net.URL} object; {@code null} if no 
resource with
       *         this name is found, the resource cannot be located by a 
URL, the
       *         resource is in a package that is not
-     *         {@link Module#isOpen(String, Module) open} to at least 
the caller
+     *         {@linkplain Module#isOpen(String, Module) open} to at 
least the caller
       *         module, or access to the resource is denied by the security
       *         manager.
       * @throws NullPointerException If {@code name} is {@code null}



More information about the core-libs-dev mailing list