RFR: 8367382: Expand use of representation equivalence terminology [v2]

[Raffaello Giulietti]

On Fri, 12 Sep 2025 00:44:38 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> Small doc enhancement to use the term "representation equivalence" in a few more locations.
>
> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Fix typo found in code review.

src/java.base/share/classes/java/lang/Double.java line 1462:

> 1460:      * @apiNote
> 1461:      * One idiom to implement {@linkplain
> 1462:      * Double##repEquivalence representation equivalence} on {@code

Suggestion:

     * ##repEquivalence representation equivalence} on {@code

for consistency with the similar change in `equals()`

src/java.base/share/classes/java/lang/Float.java line 874:

> 872:      * returns the identical {@code int} value when applied to
> 873:      * each.
> 874:      * In other words, {@linkplain ##repEquivalence representation

Suggestion:

     * In other words, {@linkplain Double##repEquivalence representation

I think the class name is needed here.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/27232#discussion_r2343493915
PR Review Comment: https://git.openjdk.org/jdk/pull/27232#discussion_r2343494067