From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] elisp manual patch: add to file notification documentation Date: Tue, 13 Dec 2022 20:05:07 +0100 Message-ID: <87pmcnruos.fsf@gmx.de> References: <87bko8knq2.fsf@rabkins.net> <87k02vu32l.fsf@gmx.de> <871qp3i4wu.fsf@rabkins.net> <87y1rbrwel.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3312"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Yoni Rabkin , emacs-devel To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 13 20:05:59 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 1p5AbH-0000hF-0s for ged-emacs-devel@m.gmane-mx.org; Tue, 13 Dec 2022 20:05:59 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p5Aae-0006Uz-C8; Tue, 13 Dec 2022 14:05:20 -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 1p5Aaa-0006Ud-Rq for emacs-devel@gnu.org; Tue, 13 Dec 2022 14:05:16 -0500 Original-Received: from mout.gmx.net ([212.227.15.15]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p5AaZ-0004sF-6a for emacs-devel@gnu.org; Tue, 13 Dec 2022 14:05:16 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1670958308; bh=O9KcDRYDsb0MOmA3nszcLrueZ/D/30kHYnIEOphT30A=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date; b=qrdTy8xBMZML2aS/d1aD4Uf8i4DXPkM9kz+UhcfLw0VgSmuSLWbZKzVawg2xz/75G i8rC1cP280RMh4Nw7cBUVlFcQVv7INoLIey3z29EkckJShy4qwRzrZo61lSRvAbfP2 KcYd0AcLZxxMkffGz5QBtULuxarub1/f/ldW7/1Y7jzqkws+6IGD3STP4Sfign6bqe AhsshJW5fqJsUhZD5B4VTK44UU0dMy+g6Lz7TPhK79ReILPtAJEAjoE8D13M6ySTgR Zdh+l6Rd0MHS058Y2T3rbTDOjMpHQqSeGt3ZkVqM0ZkH7WBnI7qinOyn40OMeBEbOY FGsxAdZmFvnNQ== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Original-Received: from gandalf.gmx.de ([185.89.39.11]) by mail.gmx.net (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1M7K3i-1ozfse2Uyi-007nii; Tue, 13 Dec 2022 20:05:08 +0100 In-Reply-To: (Stefan Kangas's message of "Tue, 13 Dec 2022 10:52:27 -0800") X-Provags-ID: V03:K1:wECgcBjpd4JWJfWRn2aBDTnzLJv/80J79HNrk+PGZ52FDhK91AB d1d7uzF+1Bj13WcgEKf852sEuk2DT1dqofrmeZ8UFtpQFYrgBzuqz1Fm6rC9huiY1xVoZgo Ioawgt4yFSjRVq4h4B4jP5nM+q+QjEO+Gz5n/Ay3APs/e13PEXY/AP7GBDx8KDjn/0dNIKj jusU8/GlBdym/BANPl2iw== UI-OutboundReport: notjunk:1;M01:P0:XZaoLxPH1+Q=;77GCqtynm64mhsCWid5Szx40PMd b/N9c3ExdpDZIoUDHB0izipnPloh4DeznvQVhxePDCc8ioljbwUpFSRpcdbwI4Zxv7dqHJmOC bLp4CVCThFeQQKhWMQyg9TX9Y4pr5o7xN/xXRtHVZN5JG9N/cDGs6oX3Cs6s9Dp4iBd49NlfK 4km40uMWEXPLabVLvvOwlqkBSckm88z+AXDUEK7rf0aqeIVSGGRXCWsLgNIJfWZ7wKycmoGFc 5Gr3gqamQUBTZ5jDCgifGdsc1eWVL0XPW6zPBEPNNnxLoNKpj/HBnW/oPPUfCL6oBAWGCucj4 6Gi4FMBUp7eYf5DPisrkGXhpJlX8jTS8ybKaYeMDQ17jLEB91FEJR2VY13UnpbabXZFIcjar6 oXjGiTq2o+QFGxRVsbvqdWg5cJw2pIorVQdIiyp64kDI4VeEop58Uy/ZfmMmy+sCRgZbDv/Ni koNvcbT81iLLPQYswOBtL3EvZ2g8nGrP1KCLqERlrW1FRNQtNPDKn5jql2A+lBywQfUEVQad1 /qMAbSFZvhGMkR0Gw5JX8wJ6o1B3s39yl5DZ1zM/gcKdjTXFHgQ7Bav0Yt+nFLa9Kx/1dhbLL zjwKxXt3HTtoHmf3jFyDcz0Jw4lhD70+cd4JJYvwMGKiEBESw7dafX/Ns6/6UP5LCLPZ2PL1v Py40rGgKzujvcXcahfYPdVfkqyT+Mo0B9WFeAEghUxZRCu4aAlkuj5yQVPd4JwWw0vYWLw6Vm +Udq71I8XsBPQkbX9H34i2C9yKmXr+fa4OOWB65HIPGNofT7ItJePA1XuzcKcIPeJ2aenw7y Received-SPF: pass client-ip=212.227.15.15; envelope-from=michael.albinus@gmx.de; helo=mout.gmx.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, 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:301349 Archived-At: Stefan Kangas writes: >> It's not that simple. Emacs might be compiled with file notification, >> but it isn't possible for remote files. Emacs might be compiled without >> file notification, but it is still possible for remote files. >> >> And even if it is possible for local or remote files, it might not work >> on NFS mounted file systems. >> >> The value of file-notify--library is a vague approximation for being >> able to use file notifications. That's the reason for being an internal >> constant only. >> >> Calling file-notify-add-watch gives you more precise results. > > Would it make sense to add something like the above to the docstring of > `file-notify--library'? After all, it's an internal constant. And it is about the local file notification library only. If you want to go into dirty details, you must even apply much more analysis, in order to understand its behavior. gio, for example, supports different backends, which behave differently. See for example the functions file-notify--test-library and file-notify--test-monitor in filenotify-tests.el. They are not perfect, but good for now. If we want to extend the documentation with this information, the manual node "(elisp) File Notifications" would be the better place. But I'm not sure whether this is of general interest. Best regards, Michael.