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

[Michael Albinus]

branch: master
commit c094b8c20a79c731cd36e86a3a6bc777606586bc
Author: Michael Albinus <michael.albinus@gmx.de>
Commit: Michael Albinus <michael.albinus@gmx.de>

    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 7c7673f..1fbd664 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