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

View File

@ -134,7 +134,7 @@ public abstract class Reference<T> {
* [inactive/unregistered]
*
* Unreachable states (because enqueue also clears):
* [active/enqeued]
* [active/enqueued]
* [active/dequeued]
*
* [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
* collection or finalization.
*
* <p> This method establishes an ordering for
* <a href="package-summary.html#reachability"><em>strong reachability</em></a>
* <p> This method establishes an ordering for <em>strong reachability</em>
* with respect to garbage collection. It controls relations that are
* otherwise only implicit in a program -- the reachability conditions
* 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.
* @since 9
* @jls 12.6 Finalization of Class Instances
*/
@ForceInline
public static void reachabilityFence(Object ref) {