[lworld] RFR: 8346307: [lworld] Clarify identity vs value in Class, Objects, and document limitations of value objects [v10]

[Roger Riggs]

On Thu, 26 Jun 2025 19:38:27 GMT, Roger Riggs <rriggs at openjdk.org> wrote:

>> Add APINote  and javadoc for IdentityException where it will be useful to know that identity or value objects are treated differently. 
>> Simplified WeakHashMap javadoc updates for IdentityException. 
>> Added note to System.identityHashCode to include value objects.
>> Added to class javadoc for IdentityHashMap for value objects.
>
> Roger Riggs has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Correctly describe computation of identityHashCode

If there are no more comments, I'll push this into Valhalla tomorrow.

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

PR Comment: https://git.openjdk.org/valhalla/pull/1327#issuecomment-3025332991