# HG changeset patch
# User darcy
# Date 1556900759 25200
# Node ID 90855d9c3c39816a704232f15557d3c338ee0149
# Parent  b7e6fc77c2f388654e210563a59fbc2d4658b5eb
8223265: Clarify operational semantics of java.util.Objects.equals()
Reviewed-by: bpb, alanb

diff -r b7e6fc77c2f3 -r 90855d9c3c39 src/java.base/share/classes/java/util/Objects.java
--- a/src/java.base/share/classes/java/util/Objects.java	Fri May 03 09:07:30 2019 -0700
+++ b/src/java.base/share/classes/java/util/Objects.java	Fri May 03 09:25:59 2019 -0700
@@ -62,10 +62,11 @@
      * Returns {@code true} if the arguments are equal to each other
      * and {@code false} otherwise.
      * Consequently, if both arguments are {@code null}, {@code true}
-     * is returned and if exactly one argument is {@code null}, {@code
-     * false} is returned.  Otherwise, equality is determined by using
-     * the {@link Object#equals equals} method of the first
-     * argument.
+     * is returned.  Otherwise, if the first argument is not {@code
+     * null}, equality is determined by calling the {@link
+     * Object#equals equals} method of the first argument with the
+     * second argument of this method. Otherwise, {@code false} is
+     * returned.
      *
      * @param a an object
      * @param b an object to be compared with {@code a} for equality