8274071: Clean up java.lang.ref comments and documentation
Reviewed-by: rriggs, kbarrett, mchung, iris, lancea
This commit is contained in:
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) {
|
||||||
|
Loading…
x
Reference in New Issue
Block a user