From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yoni Rabkin Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] elisp manual patch: add to file notification documentation Date: Tue, 13 Dec 2022 12:18:53 -0500 Message-ID: <875yefi5mq.fsf@rabkins.net> References: <87bko8knq2.fsf@rabkins.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15117"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) Cc: emacs-devel , Michael Albinus To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 13 18:20:05 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1p58wl-0003ie-TV for ged-emacs-devel@m.gmane-mx.org; Tue, 13 Dec 2022 18:20:04 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p58vp-0004Nh-My; Tue, 13 Dec 2022 12:19:05 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p58vn-0004N8-Jc for emacs-devel@gnu.org; Tue, 13 Dec 2022 12:19:03 -0500 Original-Received: from smtprelay0016.hostedemail.com ([216.40.44.16] helo=relay.hostedemail.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p58vm-00033f-0T for emacs-devel@gnu.org; Tue, 13 Dec 2022 12:19:03 -0500 Original-Received: from omf18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 724F74057D; Tue, 13 Dec 2022 17:18:57 +0000 (UTC) Original-Received: from [HIDDEN] (Authenticated sender: yoni@rabkins.net) by omf18.hostedemail.com (Postfix) with ESMTPA id ADFCC31; Tue, 13 Dec 2022 17:18:54 +0000 (UTC) X-Ethics: Use GNU In-Reply-To: (Stefan Kangas's message of "Mon, 12 Dec 2022 19:25:38 -0800") X-Rspamd-Queue-Id: ADFCC31 X-Stat-Signature: kteeed7ts1xbg43dhyyr6h1t474gs95h X-Rspamd-Server: rspamout02 X-Session-Marker: 796F6E69407261626B696E732E6E6574 X-Session-ID: U2FsdGVkX19/P6fUHGG8HQVgjovgvtya5/Ce+5HZ1Kc= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rabkins.net; h=from:to:cc:subject:references:date:in-reply-to:message-id:mime-version:content-type; s=dkim1; bh=GtDhaTO+W6fvND9ds/mximZQQ0HsCVrnhDYciBsdhcs=; b=NRJui/y+2wS6UHTdpkeD+aTnoYJj5MUNGuMPpU1df2Glb1wSvfUtec7fcn++nfxlwg+xM6qGMldMLvQ6GjZKHniJyrLni3x4UT4EIIB3kY0kgopjg3TS9zyd5OjgXNs7Y75m8BpGgD1z+i6NPw0P2cx9nJ0+QG99B1Sm3AdGK+g= X-HE-Tag: 1670951934-650642 X-HE-Meta: U2FsdGVkX1/+Iq5A75yVzRePq08bG9brSQkZTzaqOfZi/JQ1bCDzFJuY/rZKQm62zh8tqU8QEi2Bb4URPP43Xg== Received-SPF: pass client-ip=216.40.44.16; envelope-from=yoni@rabkins.net; helo=relay.hostedemail.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, UNPARSEABLE_RELAY=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:301329 Archived-At: Stefan Kangas writes: > Yoni Rabkin writes: > >> The following elisp manual documentation patch explains to the user how >> to check if their emacs was compiled with file notification support. > > If this is supposed to be user-facing, shouldn't it be renamed to > `file-notify-library'? Is the content of the elisp manual supposed to be user-facing? I guess it depends on how you all define that term. When I wrote "user" above, I was referring to the "user" of the elisp manual, who is a person writing elisp. >> diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi >> index 3e16ac0..2546074 100644 >> --- a/doc/lispref/os.texi >> +++ b/doc/lispref/os.texi >> @@ -3146,6 +3146,10 @@ respective library like @file{inotify}, @file{kqueue}, >> @file{gfilenotify}, or @file{w32notify} statically. These libraries >> enable watching of filesystems on the local machine. >> >> +The variable @var{file-notify--library} is non-nil when Emacs has been >> +compiled with file notification support, and value is the name of the >> +low-level file notification package to be used for local file systems. >> + >> It is also possible to watch filesystems on remote machines, >> @pxref{Remote Files,, Remote Files, emacs, The GNU Emacs Manual}. >> This does not depend on one of the libraries linked to Emacs. > -- "Cut your own wood and it will warm you twice"