8225675: Outdated citation of JLS in java.lang.ref.Reference

Reviewed-by: lancea, jjg, mchung
This commit is contained in:
Joe Darcy 2019-06-12 14:14:39 -07:00
parent 9c5a2bf5af
commit 78f3c596a3

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -418,10 +418,10 @@ public abstract class Reference<T> {
* {@code synchronized} blocks or methods, or using other synchronization * {@code synchronized} blocks or methods, or using other synchronization
* facilities are not possible or do not provide the desired control. This * facilities are not possible or do not provide the desired control. This
* method is applicable only when reclamation may have visible effects, * method is applicable only when reclamation may have visible effects,
* which is possible for objects with finalizers (See * which is possible for objects with finalizers (See Section 12.6
* <a href="https://docs.oracle.com/javase/specs/jls/se8/html/jls-12.html#jls-12.6"> * of <cite>The Java&trade; Language Specification</cite>) that
* Section 12.6 17 of <cite>The Java&trade; Language Specification</cite></a>) * are implemented in ways that rely on ordering control for
* that are implemented in ways that rely on ordering control for correctness. * correctness.
* *
* @apiNote * @apiNote
* Finalization may occur whenever the virtual machine detects that no * Finalization may occur whenever the virtual machine detects that no
@ -508,6 +508,7 @@ public abstract class Reference<T> {
* *
* @param ref the reference. If {@code null}, this method has no effect. * @param ref the reference. If {@code null}, this method has no effect.
* @since 9 * @since 9
* @jls 12.6 Finalization of Class Instances
*/ */
@ForceInline @ForceInline
public static void reachabilityFence(Object ref) { public static void reachabilityFence(Object ref) {