From c094b8c20a79c731cd36e86a3a6bc777606586bc Mon Sep 17 00:00:00 2001 From: Michael Albinus Date: Sun, 17 Oct 2021 09:36:59 +0200 Subject: [PATCH] Warn about `file-notify-rm-all-watches' side effects * doc/lispref/os.texi (File Notifications): Warn about `file-notify-rm-all-watches' side effects. --- doc/lispref/os.texi | 4 ++++ 1 file changed, 4 insertions(+) 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 -- 2.39.2