8274071: Clean up java.lang.ref comments and documentation

Reviewed-by: rriggs, kbarrett, mchung, iris, lancea
This commit is contained in:
Pavel Rappo 2021-09-22 13:42:23 +00:00
parent 71788c69db
commit c6df3c9571

@ -134,7 +134,7 @@ public abstract class Reference<T> {
* [inactive/unregistered] * [inactive/unregistered]
* *
* Unreachable states (because enqueue also clears): * Unreachable states (because enqueue also clears):
* [active/enqeued] * [active/enqueued]
* [active/dequeued] * [active/dequeued]
* *
* [1] Unregistered is not permitted for FinalReferences. * [1] Unregistered is not permitted for FinalReferences.
@ -510,8 +510,7 @@ public abstract class Reference<T> {
* this method. Invocation of this method does not itself initiate garbage * this method. Invocation of this method does not itself initiate garbage
* collection or finalization. * collection or finalization.
* *
* <p> This method establishes an ordering for * <p> This method establishes an ordering for <em>strong reachability</em>
* <a href="package-summary.html#reachability"><em>strong reachability</em></a>
* with respect to garbage collection. It controls relations that are * with respect to garbage collection. It controls relations that are
* otherwise only implicit in a program -- the reachability conditions * otherwise only implicit in a program -- the reachability conditions
* triggering garbage collection. This method is designed for use in * triggering garbage collection. This method is designed for use in
@ -609,7 +608,6 @@ 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) {