diff --git a/src/java.base/share/classes/java/lang/ref/package-info.java b/src/java.base/share/classes/java/lang/ref/package-info.java
index 94e8f8de55d01..f5384206ef03d 100644
--- a/src/java.base/share/classes/java/lang/ref/package-info.java
+++ b/src/java.base/share/classes/java/lang/ref/package-info.java
@@ -134,8 +134,8 @@
*
*
*
Memory Consistency Properties
- * Certain interactions between the garbage collector, references, and reference
- * queues form
+ * Certain interactions between references, references queues, and the garbage
+ * collector form
* happens-before
* relationships:
*
@@ -154,20 +154,34 @@
*
* The dequeuing of a reference to a
* {@linkplain Cleaner#register(Object object, Runnable action) registered}
- * object, by the Cleaner thread, happens-before the Cleaner thread runs
+ * object, by a Cleaner thread, happens-before that Cleaner thread runs
* the cleaning action for that object.
*
- * For finalizers: actions in a thread prior to calling
+ *
+ * The above chain of happens-before edges ensures that actions in a
+ * thread prior to a {@link Reference#reachabilityFence Reference.reachabilityFence(x)}
+ * happen-before cleanup code for {@code x} runs on a Cleaner thread.
+ * In particular, changes to the state of {@code x} made before
+ * {@code reachabilityFence(x)} will be visible to the cleanup code running on
+ * a Cleaner thread without additional synchronization.
+ * See {@jls 17.4.5}.
+ *
+ *
+ * The interaction between references, finalizers, and the garbage collector
+ * also forms a happens-before relationship:
+ *
+ *
+ * - Actions in a thread prior to calling
* {@link Reference#reachabilityFence Reference.reachabilityFence(x)}
* happen-before the finalizer for x is run by a finalizer thread.
*
*
- * The above chain of happens-before edges ensures that actions in a
- * thread prior to a {@link Reference#reachabilityFence Reference.reachabilityFence(x)}
- * happen-before cleanup code for {@code x} runs on a cleaner/finalizer thread.
+ * This ensures that actions in a thread prior to a
+ * {@link Reference#reachabilityFence Reference.reachabilityFence(x)}
+ * happen-before cleanup code for {@code x} runs on a finalizer thread.
* In particular, changes to the state of {@code x} made before
* {@code reachabilityFence(x)} will be visible to the cleanup code running on
- * a cleaner/finalizer thread without additional synchronization.
+ * a finalizer thread without additional synchronization.
* See {@jls 17.4.5}.
*
* @author Mark Reinhold