Integrated: 8261123: Augment discussion of equivalence classes in Object.equals and comparison methods

[Joe Darcy]

On Tue, 9 Feb 2021 06:42:26 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> A follow-up of sorts to JDK-8257086, this change aims to improve the discussion of the relationship between Object.equals and compareTo and compare methods. The not-consistent-with-equals natural ordering of BigDecimal get more explication too. While updating Object, I added some uses of apiNote and implSpec, as appropriate. While a signum method did not exist when Comparable was added, it has existed for many years so I removed obsolete text that defined a "sgn" function to compute signum.
> 
> Once the changes are agreed to, I'll reflow paragraphs and update the copyright years.

This pull request has now been integrated.

Changeset: d547e1a8
Author:    Joe Darcy <darcy at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/d547e1a8
Stats:     151 lines in 4 files changed: 52 ins; 16 del; 83 mod

8261123: Augment discussion of equivalence classes in Object.equals and comparison methods

Reviewed-by: bpb, smarks, rriggs

-------------

PR: https://git.openjdk.java.net/jdk/pull/2471