On Thu, 16 Jul 2026 20:01:46 GMT, Joe Darcy <[email protected]> wrote:
>> src/java.base/share/classes/java/lang/doc-files/ValueBased.html line 76:
>>
>>> 74: <p>When preview features are enabled, some value-based classes become
>>> value classes.
>>> 75: Instances of these classes become value objects, which have
>>> different identity-related
>>> 76: behaviors compared to identity objects, as described in {@link
>>> Object}:</p>
>>
>> I don't want to treat Object as the Source of Truth here, maybe just delete
>> "as desribed in Object:" and say "including:".
>
> Shouldn't the specification of `java.lang.Object` be the source of truth for
> the semantics of `Object`?
Sure, but not necessarily the authoritative catalog of all "different
identity-related behaviors compared to identity objects". Some of that is
language semantics, some of that is the behavior of particular APIs that
interact with value objects, etc.
-------------
PR Review Comment:
https://git.openjdk.org/valhalla/pull/2631#discussion_r3598598372
