From 5cc7175514571e41cc31219df1ae9dbd8e6b69f9 Mon Sep 17 00:00:00 2001
From: Santiago Gimeno <santiago.gimeno@gmail.com>
Date: Sat, 17 Aug 2024 13:44:37 +0200
Subject: [PATCH] doc: document specific macOS fs_event behavior (#4503)

---
 docs/src/fs_event.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/src/fs_event.rst b/docs/src/fs_event.rst
index 3c105c7b..983db1a9 100644
--- a/docs/src/fs_event.rst
+++ b/docs/src/fs_event.rst
@@ -113,6 +113,9 @@ API
 
     .. note:: Currently the only supported flag is ``UV_FS_EVENT_RECURSIVE`` and
               only on OSX and Windows.
+    .. note:: On macOS, events collected by the OS immediately before calling
+              ``uv_fs_event_start`` might be reported to the `uv_fs_event_cb`
+              callback.
 
 .. c:function:: int uv_fs_event_stop(uv_fs_event_t* handle)