On Tue, 19 Mar 2024 00:40:02 GMT, Y. Srinivas Ramakrishna <y...@openjdk.org>
wrote:
>> Brent Christian has updated the pull request incrementally with one
>> additional commit since the last revision:
>>
>> further tweaks to reachability
>
> src/java.base/share/classes/java/lang/ref/package-info.java line 137:
>
>> 135: *
>> 136: * A <em>reachable</em> object is any object that can be accessed in
>> any potential
>> 137: * continuing computation from any live thread (as stated in {@jls
>> 12.6.1}).
>
> This seems like somewhat loose and sloppy wording to me. "Any potential
> continuing computation"? "Any live thread"? Could you share a pointer to JLS
> 12.6.1 being referenced here?
The phrase "live thread" is used in a number of places in the API docs to mean
a Thread that has been started and not has not terminated. The `@jls` tag will
create a link in the generated javadoc. If it helps, then it could also link to
Thread::isAlive.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/16644#discussion_r1529527453
