RFR: 8261123: Augment discussion of equivalence classes in Object.equals and comparison methods [v3]

[Roger Riggs]

On Fri, 12 Feb 2021 22:28:33 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> src/java.base/share/classes/java/lang/Object.java line 236:
>> 
>>> 234:      * be a concise but informative representation that is easy for a
>>> 235:      * person to read.
>>> 236:      * It is recommended that all subclasses override this method.
>> 
>> Do we want to have a general note here or somewhere that the exact format of the result of `toString()` is generally not stable, and that it is subject to change without notice?
>
> Added "The string output is not necessary stable over time." The particulars of the toString contract of a given class will depend on the class of course.

Perhaps "necessary" -> "necessarily"

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

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