CR

Co-authored-by: Moshe Atlow <moshe@atlow.co.il>

Author: atlowChemi

doc/api/events.md

@@ -1673,12 +1673,11 @@ changes:
 * `eventName` {string|symbol} The name of the event being listened for
 * `options` {Object}
   * `signal` {AbortSignal} Can be used to cancel awaiting events.
-  * `close` - {string\[]} Can be used to set event names that will end
-    the iteration.
+  * `close` - {string\[]} Event names that will end the iteration.
   * `highWatermark` - {integer} **Default:** `Number.MAX_SAFE_INTEGER`
-    Sets the `highWaterMark` used for the stream.
+    The low watermark. The emitter is resumed every time size is lower than it.
   * `lowWatermark` - {integer} **Default:** `1`
-    Sets the `lowWaterMark` used for the stream.
+    The high watermark. The emitter is paused every time size is higher than it.
 * Returns: {AsyncIterator} that iterates `eventName` events emitted by the `emitter`
 
 ```mjs