Subject: Re: bug#26126: 26.0.50; file-notify-rm-watch removes arbitrary watches

From: Eli Zaretskii <[email-masked]>
Date: Thu, 23 Mar 2017 17:22:22 +0200

> From: Michael Albinus <[email-masked]>
> Cc: [email-masked],  [email-masked]
> Date: Thu, 23 Mar 2017 08:36:39 +0100
> 
> > IMO, Lisp programs should always go through filenotify.el, never via
> > backend-specific APIs.
> 
> Then we shall emphasize this in the manual. Like this?
> 
> --8<---------------cut here---------------start------------->8---
> diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
> index 9b6752c..09f7c18 100644
> --- a/doc/lispref/os.texi
> +++ b/doc/lispref/os.texi
> @@ -2707,7 +2707,8 @@ File Notifications
>  
>  Since all these libraries emit different events on notified file
>  changes, there is the Emacs library @code{filenotify} which provides a
> -unique interface.
> +unified interface.  It is highly recommended to use this library
> +instead of the native ones.

I'd say that even more definitively:

  Lisp programs that want to receive file notifications should always
  use this library in preference to the native ones.