On Mon, 27 Jul 2026 19:40:40 GMT, Roger Riggs <[email protected]> wrote:
>> Chen Liang has updated the pull request incrementally with one additional
>> commit since the last revision:
>>
>> "referent"
>
> src/java.base/share/classes/java/lang/doc-files/ValueBased.html line 69:
>
>> 67:
>> 68: <p>Use of instances of value-based classes in {@linkplain
>> 69: java.lang.ref.Reference reference objects} is strongly discouraged,
>
> The use of "in" reference objects is a bit vague, java.lang.ref.Reference can
> be subclassed and this might be interpreted as using a value class as a field
> in the subclass, that would be an ok use.
>
> It would be clearer to be more direct and say java.lang.ref.Reference
> instances can not refer to value class instances.
I have qualified the use to be "as referents". "Referent" is the defined term
in java.lang.ref package about such a use. Also updated the CSR.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/32055#discussion_r3660545030
