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

[Joe Darcy]

On Thu, 11 Feb 2021 04:22:18 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Fix typos in javadoc tags found during review.
>
> 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.

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

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