On Wed, 18 Jun 2025 17:51:20 GMT, Doug Lea <d...@openjdk.org> wrote: > This collects miscellaneous open issues that can be resolved with > documentation updates; each indicated by adding JDK issue numbers
This pull request has now been integrated. Changeset: ff24088c Author: Doug Lea <d...@openjdk.org> URL: https://git.openjdk.org/jdk/commit/ff24088c866864fa670bbfdd068b1a50b6bcf0db Stats: 305 lines in 20 files changed: 83 ins; 1 del; 221 mod 8359919: Minor java.util.concurrent doc improvements 8187775: AtomicReferenceFieldUpdater does not support static fields 8254060: SubmissionPublisher close hangs if a publication is pending 8210149: Example in JavaDoc for java.util.concurrent.Flow violates Reactive Streams spec 8199501: Improve documentation of CompletableFuture, CompletionStage 8233050: CompletableFuture `whenComplete` and `thenApply` change exceptional result 8210312: JavaDoc example in SubmissionPublisher will potentially crash 8292365: CompletableFuture and CompletionStage should document Memory Model guarantees 8356304: Define "enabled" in ScheduledExecutorService 8353155: FutureTask#run(): doc implies synchronous, implementation is async 8186959: Clarify that Executors.newScheduledThreadPool() is fixed-size 8190889: TimeUnit.wait should document IllegalMonitorStateException 6351533: CyclicBarrier reset() should return the number of awaiters 6317534: CyclicBarrier should have a cancel() method 8195628: Documentation for lock(), trylock(), lockInterruptibly​() of ReentrantReadWriteLock.WriteLock needs to be corrected 8333172: Document a recommendation to use VarHandles instead of java.util.concurrent.atomic.*FieldUpdater 6374942: Improve thread safety of collection .equals() methods 7176957: ExecutorService submit method javaDoc enhancement 8172177: Improve documentation for CompletionException handling 6714849: ReentrantReadWriteLock: Abnormal behavior in non-fair mode 6625724: Allow ReentrantReadWriteLock to not track per-thread read holds 6526284: Improve AbstractExecutorService javadoc 8137156: Javadoc for Future is misleading with respect to cancellation 6663476: FutureTask.get() may return null if set() is not called from run() 8311131: ConcurrentHashMap.forEachKey parallelismThreshold description could be clearer Reviewed-by: alanb ------------- PR: https://git.openjdk.org/jdk/pull/25880
