From 76e2455b064585f2590620838f5790d7715758eb Mon Sep 17 00:00:00 2001
From: Bartosz Sosnowski <bartosz@janeasystems.com>
Date: Tue, 10 Mar 2020 16:02:19 +0100
Subject: [PATCH] doc: expand fs.watch caveats

Document Windows specific fs.watch caveats.

Fixes: https://github.com/nodejs/node/issues/31702

PR-URL: https://github.com/nodejs/node/pull/32176
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Masashi Hirano <shisama07@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/fs.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 8a96797fb68bc1..1ce1e06f2c7dcf 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -3758,6 +3758,9 @@ unavailable in some situations.
 
 The recursive option is only supported on macOS and Windows.
 
+On Windows, no events will be emitted if the watched directory is moved or
+renamed. An `EPERM` error is reported when the watched directory is deleted.
+
 #### Availability
 
 <!--type=misc-->