RFR: 8330077: Allow max number of events to be buffered to be configurable to avoid OVERFLOW_EVENT [v5]

[Brian Burkhalter]

On Tue, 16 Apr 2024 06:10:28 GMT, Fabian Meumertzheim <duke at openjdk.org> wrote:

> I added the note to `WatchKey#poll` since that is what returns the list, but can also move it to `WatchService` as it is the more canonical API entrypoint.

I think that it might be better to add it to the class level doc of `WatchService`.

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

PR Comment: https://git.openjdk.org/jdk/pull/18739#issuecomment-2060188775