The behavior of equals methods and comparators could be clarified by more explicitly discussing the equivalence classes those methods define. Such discussions would be especially helpful for classes like BigDecimal where the natural ordering is *inconsistent* with equals.
- csr for
-
JDK-8261688 Augment discussion of equivalence classes in Object.equals and comparison methods
- Closed
- duplicates
-
JDK-8080449 doc for Object.toString should use @implSpec
- Closed
- relates to
-
JDK-8285614 Fix typo in java.lang.Float
- Resolved
-
JDK-8261862 Expand discussion of rationale for BigDecimal equals/compareTo semantics
- Resolved
-
JDK-8257086 Clarify differences between {Float, Double}.equals and ==
- Resolved
(2 links to)