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

[Maurizio Cimadamore]

On Wed, 2 Apr 2025 09:13:21 GMT, Per Minborg <pminborg at openjdk.org> wrote:

>> src/java.base/share/classes/java/lang/StableValue.java line 52:
>> 
>>> 50:  * A stable value is a deferred holder of shallowly immutable content.
>>> 51:  * <p>
>>> 52:  * A {@code StableValue<T>} can be created using the factory method
>> 
>> s/can be/is (more direct) -- here and elsewhere
>
> The reason we use the notion "can be" rather than "is" is that a `StableValue` can alternately be created via the `StableValue.of(initialValue)` method. In the latter case, it is already set.

You are correct. I suggest replacing `can be created` with `is typically created` (to suggest we envision that to be the common case.

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

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