summaryrefslogtreecommitdiff
path: root/doc/lispref/os.texi
diff options
context:
space:
mode:
authorMichael Albinus <michael.albinus@gmx.de>2021-10-17 09:36:59 +0200
committerMichael Albinus <michael.albinus@gmx.de>2021-10-17 09:36:59 +0200
commitc094b8c20a79c731cd36e86a3a6bc777606586bc (patch)
tree9cc6da44079b1a606c02a6c0d13a572babaf3076 /doc/lispref/os.texi
parentae9bfaa891c4f3cacb118aef6e35432d5fbeb88d (diff)
downloademacs-c094b8c20a79c731cd36e86a3a6bc777606586bc.tar.gz
emacs-c094b8c20a79c731cd36e86a3a6bc777606586bc.tar.bz2
emacs-c094b8c20a79c731cd36e86a3a6bc777606586bc.zip
Warn about `file-notify-rm-all-watches' side effects
* doc/lispref/os.texi (File Notifications): Warn about `file-notify-rm-all-watches' side effects.
Diffstat (limited to 'doc/lispref/os.texi')
-rw-r--r--doc/lispref/os.texi4
1 files changed, 4 insertions, 0 deletions
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