5066247: Refine the spec of equals() and hashCode() for j.text.Format classes

Reviewed-by: naoto, darcy

src/java.base/share/classes/java/text/ChoiceFormat.java

@@ -572,7 +572,11 @@ public class ChoiceFormat extends NumberFormat {
     }
 
     /**
-     * Generates a hash code for the message format object.
+     * {@return the hash code for this {@code ChoiceFormat}}
+     *
+     * @implSpec This method calculates the hash code value using the values returned by
+     * {@link #getFormats()} and {@link #getLimits()}.
+     * @see Object#hashCode()
      */
     @Override
     public int hashCode() {
@@ -585,7 +589,17 @@ public class ChoiceFormat extends NumberFormat {
     }
 
     /**
-     * Equality comparison between two
+     * Compares the specified object with this {@code ChoiceFormat} for equality.
+     * Returns true if the object is also a {@code ChoiceFormat} and the
+     * two formats would format any value the same.
+     *
+     * @implSpec This method performs an equality check with a notion of class
+     * identity based on {@code getClass()}, rather than {@code instanceof}.
+     * Therefore, in the equals methods in subclasses, no instance of this class
+     * should compare as equal to an instance of a subclass.
+     * @param  obj object to be compared for equality
+     * @return {@code true} if the specified object is equal to this {@code ChoiceFormat}
+     * @see Object#equals(Object)
      */
     @Override
     public boolean equals(Object obj) {