From: Michael Albinus <michael.albinus@gmx.de>
Date: Sun, 17 Oct 2021 07:36:59 +0000 (+0200)
Subject: Warn about `file-notify-rm-all-watches' side effects
X-Git-Tag: emacs-29.0.90~3671^2~539
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c094b8c20a79c731cd36e86a3a6bc777606586bc;p=emacs.git

Warn about `file-notify-rm-all-watches' side effects

* doc/lispref/os.texi (File Notifications): Warn about
`file-notify-rm-all-watches' side effects.
---

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 7c7673f9c5c..1fbd66458a4 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -3233,6 +3233,10 @@ Removes an existing file watch specified by its @var{descriptor}.
 
 @deffn Command file-notify-rm-all-watches
 Removes all existing file notification watches from Emacs.
+
+Use this command with caution, because it could have unexpected side
+effects on packages relying on file watches.  It is intended mainly
+for debugging purposes, or when Emacs has been stalled.
 @end deffn
 
 @defun file-notify-valid-p descriptor