RFR: 8351565: Implement JEP 502: Stable Values (Preview) [v33]

[Viktor Klang]

On Wed, 2 Apr 2025 14:06:22 GMT, Viktor Klang <vklang at openjdk.org> wrote:

>> Per Minborg has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Add info that Map#values and Map#entrySet are stable
>
> src/java.base/share/classes/java/lang/StableValue.java line 50:
> 
>> 48: 
>> 49: /**
>> 50:  * A stable value is a holder of shallowly immutable content that can be lazily computed.
> 
> This reads as if the content can only be shallowly immutable (not deeply immutable).
> 
> How about saying "effectively immutable" instead?

Or "observably immutable"? 🤔

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23972#discussion_r2024910652