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/ScheduledExecutorService.java line 48:

> 46:  * that {@code scheduleAtFixedRate} and {@code scheduleWithFixedDelay}
> 47:  * methods create and execute tasks that run periodically until
> 48:  * cancelled.

I think this wording, and use of "enabled", is good.

In passing, the first paragraph schedule "tasks" but returns "a task object". It might be saying that it returns task objects.

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

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