From: Michael Albinus 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