From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] elisp manual patch: add to file notification documentation Date: Mon, 12 Dec 2022 19:25:38 -0800 Message-ID: References: <87bko8knq2.fsf@rabkins.net> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1015"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Michael Albinus To: Yoni Rabkin , emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 13 04:26:36 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 1p4vwA-00005B-VY for ged-emacs-devel@m.gmane-mx.org; Tue, 13 Dec 2022 04:26:34 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p4vvO-0004Sl-IS; Mon, 12 Dec 2022 22:25:46 -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 1p4vvM-0004SE-8A for emacs-devel@gnu.org; Mon, 12 Dec 2022 22:25:44 -0500 Original-Received: from mail-oa1-x31.google.com ([2001:4860:4864:20::31]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p4vvI-0000sl-4t for emacs-devel@gnu.org; Mon, 12 Dec 2022 22:25:41 -0500 Original-Received: by mail-oa1-x31.google.com with SMTP id 586e51a60fabf-142b72a728fso11000566fac.9 for ; Mon, 12 Dec 2022 19:25:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=0E88XTk/avrpF/BsRluIOvSwFbITyHeCZHCFs+kCkA0=; b=DoRU4fJ912JzHaAzNhc4FRScaa2xSM3WTJzFaeO6YaTuZvAHQ+MoHMCJyVKIvwwN5J iIiAvfKVp/RKdq09qNYIPePZcJboAQEbvNdpb2ztxRm2c/CDaRSZ1YNpoQ6Y3gak5gIe Vke5Gna9t9js3FTGc+L26IDWGdgc/AxDwTg+2oMi5io1ZFDd/5hzKO35pcsvKj+ZURNI CUq30LNKXQTVWEn/cEHvhAccPL2bxO/eoFz0v1DKP4C6TATFCoV3RuiymfLdPLiyHY7S roDvZtcu+4IoqfeRyJVvFCkjsv/2pLFzE0ZSheIQake8wCSmnBJ8zHugew8rBC+nUP8X baIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=0E88XTk/avrpF/BsRluIOvSwFbITyHeCZHCFs+kCkA0=; b=rHkUp1uQw1QsPnoqrxX+ToG7qnQnsZk8Eau8HpXICZY5dbPFeYLxNlnATtbaNjSRAZ 2lUeUY/8mjzAOtzPBY8sSrbKzo203G/X996J0xjB+iror8u+mABUjkr95+O6RwzNSzui LvN8Zg0xqTYExA6zgWGNRg8Mnl5JTe3v9uCtSHwbZuGDQ9KTMIsTjYWwHFIPGno1P4Rs xArVHEBN+T/xAuXbZ32tgdrVjaGUOxxHenvOJJHtGKlIsBtwgnJ7bEnwchzh5vzFrEag T+JAduxmySXznM4SbIVx7FREvzONn2+k5tMj5t/PxNNWpF+bctPAHejzKxKX89rtdFsI b/qw== X-Gm-Message-State: ANoB5pktOuVvnb0YTdWUeTNEyu/PQy3LahbidKj5zAf7aeYnREuEUraO q+d0QKG0c8sZ+pMjqaxW0Jo5whvci9BqSSAAVM8= X-Google-Smtp-Source: AA0mqf4iDQ5F/aUGtyY2pKWiukKK5C8m/w0dVXKMq2vCX9v6MwBfytYQehiFgOpu4oImh3yiGA+xXOpFsMsj8n6qhwA= X-Received: by 2002:a05:6870:6c06:b0:145:3a7:99c with SMTP id na6-20020a0568706c0600b0014503a7099cmr89057oab.92.1670901938724; Mon, 12 Dec 2022 19:25:38 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Mon, 12 Dec 2022 19:25:38 -0800 In-Reply-To: <87bko8knq2.fsf@rabkins.net> X-Hashcash: 1:20:221213:michael.albinus@gmx.de::81U3hKYXPE9ecHuJ:zFw Received-SPF: pass client-ip=2001:4860:4864:20::31; envelope-from=stefankangas@gmail.com; helo=mail-oa1-x31.google.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-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:301295 Archived-At: 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'? > 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.