summaryrefslogtreecommitdiff
path: root/doc/lispref
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref')
-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