RFR: 8314480: Memory ordering spec updates in java.lang.ref [v13]

[Alan Bateman]

On Tue, 19 Mar 2024 00:40:02 GMT, Y. Srinivas Ramakrishna <ysr at 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