RFR: 8359919: Minor java.util.concurrent doc improvements [v8]

[Alan Bateman]

On Thu, 19 Jun 2025 22:49:17 GMT, Doug Lea <dl at openjdk.org> wrote:

>> This collects miscellaneous open issues that can be resolved with documentation updates; each indicated by adding JDK issue numbers
>
> Doug Lea has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Adding JDK-8333172 to doc improvements

src/java.base/share/classes/java/util/concurrent/locks/ReentrantReadWriteLock.java line 794:

> 792:         /**
> 793:          * Acquires the read lock only if the write lock is not held by
> 794:          * any thread at the time of invocation.

A writer can acquire the read lock. So if the current thread has the write lock then it will acquire the read lock. So maybe "another thread" is okay?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25880#discussion_r2158872332