Precise documentation of file-notify-add-watch

* doc/lispref/os.texi (File Notifications):
* lisp/filenotify.el (file-notify-add-watch): Precise, that
watching a directory includes reports on file changes for some
backends.  (Bug#51146)

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index e3297b1be7cf5ff43e76af78c6a6861ec9609851..db986178dd83c8abdb2a11000bf49249c0a9c2eb 100644 (file)
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -3124,8 +3124,9 @@ watch for file attribute changes, like permissions or modification
 time
 @end table
 
-If @var{file} is a directory, changes for all files in that directory
-will be notified.  This does not work recursively.
+If @var{file} is a directory, @code{change} watches for file creation
+or deletion in that directory.  Some of the file notification backends
+report also file changes.  This does not work recursively.
 
 When any event happens, Emacs will call the @var{callback} function
 passing it a single argument @var{event}, which is of the form

diff --git a/lisp/filenotify.el b/lisp/filenotify.el
index e0dceb704d5500e658a93a2591a0c78b9d97138f..271fa270836f50b7c9ac26637cb3d7622bcae9c0 100644 (file)
--- a/lisp/filenotify.el
+++ b/lisp/filenotify.el
@@ -390,7 +390,9 @@ include the following symbols:
                         permissions or modification time
 
 If FILE is a directory, `change' watches for file creation or
-deletion in that directory.  This does not work recursively.
+deletion in that directory.  Some of the file notification
+backends report also file changes.  This does not work
+recursively.
 
 When any event happens, Emacs will call the CALLBACK function passing
 it a single argument EVENT, which is of the form

diff --git a/test/lisp/filenotify-tests.el b/test/lisp/filenotify-tests.el
index 6125069c6b3c1c0a265298f6a7a954b67a71cc05..9be515ab176fdf837fe414beb402b512a0bc9172 100644 (file)
--- a/test/lisp/filenotify-tests.el
+++ b/test/lisp/filenotify-tests.el
@@ -743,7 +743,7 @@ delivered."
             ;; the directory.  Except for
             ;; GFam{File,Directory}Monitor, GPollFileMonitor and
             ;; kqueue.  And GFam{File,Directory}Monitor and
-            ;; GPollFileMonitordo not raise a `changed' event.
+            ;; GPollFileMonitor do not raise a `changed' event.
             ((memq (file-notify--test-monitor)
                     '(GFamFileMonitor GFamDirectoryMonitor GPollFileMonitor))
              '(created deleted stopped))