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

[Lance Andersen]

+1

--

Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive
Burlington, MA 01803
Lance.Andersen at oracle.com

Sent from my iPhone

> On Jun 13, 2018, at 8:51 PM, joe darcy <joe.darcy at oracle.com> wrote:
> 
> 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}
>