On Wed, 2 Apr 2025 09:13:21 GMT, Per Minborg <pminb...@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
