JDK 13 RFR of JDK-8225675: Outdated citation of JLS in java.lang.ref.Reference

[Lance Andersen]

+1
> On Jun 12, 2019, at 4:35 PM, Joe Darcy <joe.darcy at oracle.com> wrote:
> 
> Hello,
> 
> Please review the small patch below to address
> 
>     JDK-8225675: Outdated citation of JLS in java.lang.ref.Reference
> 
> (I'll reflow the paragraph before pushing; wanted to make the nature of the diff clearer in the review.)
> 
> Thanks,
> 
> -Joe
> 
> diff -r 1224b16c8ff4 src/java.base/share/classes/java/lang/ref/Reference.java
> --- a/src/java.base/share/classes/java/lang/ref/Reference.java Wed Jun 12 12:31:32 2019 -0700
> +++ b/src/java.base/share/classes/java/lang/ref/Reference.java Wed Jun 12 13:30:43 2019 -0700
> @@ -419,8 +419,8 @@
>       * facilities are not possible or do not provide the desired control.  This
>       * method is applicable only when reclamation may have visible effects,
>       * which is possible for objects with finalizers (See
> -     * <a href="https://docs.oracle.com/javase/specs/jls/se8/html/jls-12.html#jls-12.6">
> -     * Section 12.6 17 of <cite>The Java™ Language Specification</cite></a>)
> +     * Section 12.6 of <cite>The Java™ Language
> +     * Specification</cite>)
>       * that are implemented in ways that rely on ordering control for correctness.
>       *
>       * @apiNote
> @@ -508,6 +508,7 @@
>       *
>       * @param ref the reference. If {@code null}, this method has no effect.
>       * @since 9
> +     * @jls 12.6 Finalization of Class Instances
>       */
>      @ForceInline
>      public static void reachabilityFence(Object ref) {
> 

 <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif>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 <mailto:Lance.Andersen at oracle.com>