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

[Joe Darcy]

On Thu, 11 Feb 2021 04:17:48 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 135:
> 
>> 133:      * into <i>equivalence classes</i>; all the members of an
>> 134:      * equivalence class are equal to each other. The equal objects
>> 135:      * are substitutable for each other, at least for some purposes.
> 
> Since the preceding sentence mentions the members of an equivalence class, it might read better to say "Members are substitutable..." or possibly "Members of an equivalence class are substitutable...."

Phrasing updated to:

"Members of an equivalence class are substitutable for each other, at least for some purposes."

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

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