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

[Brent Christian]

On Thu, 30 May 2024 05:14:30 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> Brent Christian has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 69 commits:
>> 
>>  - Merge branch 'master' into refDocs2
>>  - add link to Thread.isAlive()
>>  - small review tweaks; shorten MemoryConsistency links
>>  - small grammar fixes
>>  - new section for finalizer memviz
>>  - add memviz bullet for finalization
>>  - remove quotes from dequeue
>>  - package spec updates, mostly about reference queues and dequeueing
>>  - move reachability section before notification; update section header
>>  - add details on use of reference queues; swap reachability/memviz sections
>>  - ... and 59 more: https://git.openjdk.org/jdk/compare/7bf1989f...d7cbf0d3
>
> src/java.base/share/classes/java/lang/ref/Reference.java line 491:
> 
>> 489:      * method is <b><i>unsuccessful</i></b> and returns false.
>> 490:      *
>> 491:      * <p><a href="package-summary.html#MemoryConsistency">Memory consistency effects</a>:
> 
> Note the `<a href="package-summary.thml#Foo>` syntax can be replaced with something like
> `{@link java.lang.ref##Foo}`.

Thanks. I've updated the links that don't involve italicized/emphasized text.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16644#discussion_r1621570783