improve wording in refersTo javadoc

openjdk · Oct 21, 2020 · 3a15b6a · 3a15b6a
1 parent ab4e519
commit 3a15b6a
Showing 1 changed file with 6 additions and 8 deletions.
diff --git a/src/java.base/share/classes/java/lang/ref/Reference.java b/src/java.base/share/classes/java/lang/ref/Reference.java
@@ -343,14 +343,12 @@ public T get() {
     }
 
     /**
-     * Tests if this reference object refers to {@code obj}.  If {@code obj} is
-     * {@code null}, this method returns {@code true} if this reference object
-     * refers to {@code null} or has been cleared.
-     *
-     * @param   obj the object to compare with this reference object's
-     *          referent, or {@code null}.
-     * @return  {@code true} if and only if {@code obj} is the referent
-     *          of this reference object
+     * Tests if the referent of this reference object is {@code obj}.
+     * Using a {@code null} {@code obj} returns {@code true} if the
+     * reference object has been cleared.
+     *
+     * @param  obj the object to compare with this reference object's referent
+     * @return {@code true} if {@code obj} is the referent of this reference object
      * @since 16
      */
     public final boolean refersTo(T obj) {