From unknown Mon Aug 18 08:26:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#37771: 26.3; doc for `dired-auto-revert-buffer' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 15 Oct 2019 22:36:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 37771 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 37771@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.157117891520647 (code B ref -1); Tue, 15 Oct 2019 22:36:03 +0000 Received: (at submit) by debbugs.gnu.org; 15 Oct 2019 22:35:15 +0000 Received: from localhost ([127.0.0.1]:44971 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKVPP-0005Mx-02 for submit@debbugs.gnu.org; Tue, 15 Oct 2019 18:35:15 -0400 Received: from lists.gnu.org ([209.51.188.17]:43050) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKVPN-0005Mp-66 for submit@debbugs.gnu.org; Tue, 15 Oct 2019 18:35:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38698) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iKVPL-0003WF-Vq for bug-gnu-emacs@gnu.org; Tue, 15 Oct 2019 18:35:12 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.5 required=5.0 tests=BAYES_50,RCVD_IN_DNSWL_MED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iKVPK-0002xL-HY for bug-gnu-emacs@gnu.org; Tue, 15 Oct 2019 18:35:11 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:51766) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iKVPK-0002wq-5J for bug-gnu-emacs@gnu.org; Tue, 15 Oct 2019 18:35:10 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x9FMYkNR125506 for ; Tue, 15 Oct 2019 22:35:08 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=McYao0hqeXCX0Ux2vt1qAlyNgMAewC5hqhDlBIzqmcU=; b=JkRgUPCvfx7LmC+KThK1wJ2jTwDzCqDdFyM0bLgsIdzduXyVjgc64pynQ4bveYpSq5Nv FjxI1F+1FLUI4FzY8CjOfbFvq0mUjAqWodQSBSh9WAbvnJ87UPrnFg2W87e4Y94YwvTD HpTx6wAV3JCPPajXrhRWKUvrKr+V5iB57zugaLJQV4tsXPs2v6ptXWh/jKua3S/MpY/b eTAhwZZu1zKU/wOJBFe8xtIxxqQgQZ7U12vQxgpci+y5BJQt1x41aI+kksxqNTBoWxqN Ls3aCJGA5VX2ryS27LyhDeWQwNcutjRut58MH8uqmzLQ/ibC1Bl7IzyV/NrJavGhZLsU uQ== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 2vk7frb0eg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 15 Oct 2019 22:35:08 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x9FMXWBG119029 for ; Tue, 15 Oct 2019 22:35:08 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3030.oracle.com with ESMTP id 2vn8ep5hg9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 15 Oct 2019 22:35:07 +0000 Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x9FMZ6HJ021039 for ; Tue, 15 Oct 2019 22:35:07 GMT MIME-Version: 1.0 Message-ID: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> Date: Tue, 15 Oct 2019 15:35:05 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9411 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910150194 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9411 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910150194 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 156.151.31.85 X-Spam-Score: -1.3 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Please consider improving the doc so that it does the following: * Explains what is meant by "visiting" a Dired buffer. The Emacs manuals and other doc only speak about visiting a file in a buffer. Just what constitutes "visiting" a Dired buffer? It seems like it's sufficient to display the buffer and select its window. Is that it? * Explains the Value Menu items in Customize - in particular, item `Revert changed Dired buffer'. * Explains that the option has no effect on Dired buffers containing arbitrary file lists (i.e., whose DIRNAME is a cons). It is relevant only for actual directory listings. * Lists the Lisp values that correspond to the Value Menu items. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.17763 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Mon Aug 18 08:26:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#37771: 26.3; doc for `dired-auto-revert-buffer' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Oct 2019 02:58:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37771 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 37771@debbugs.gnu.org Received: via spool by 37771-submit@debbugs.gnu.org id=B37771.157128107529196 (code B ref 37771); Thu, 17 Oct 2019 02:58:01 +0000 Received: (at 37771) by debbugs.gnu.org; 17 Oct 2019 02:57:55 +0000 Received: from localhost ([127.0.0.1]:46870 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKvz5-0007ak-SD for submit@debbugs.gnu.org; Wed, 16 Oct 2019 22:57:55 -0400 Received: from [80.91.231.51] (port=43434 helo=quimby.gnus.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKvz4-0007ac-Oz for 37771@debbugs.gnu.org; Wed, 16 Oct 2019 22:57:51 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iKvz0-0004SM-EU; Thu, 17 Oct 2019 04:57:48 +0200 From: Lars Ingebrigtsen References: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> Date: Thu, 17 Oct 2019 04:57:46 +0200 In-Reply-To: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> (Drew Adams's message of "Tue, 15 Oct 2019 15:35:05 -0700 (PDT)") Message-ID: <87zhi0krit.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > Please consider improving the doc so that it does the following: > > * Explains what is meant by "visiting" a Dired buffer. The Emacs > manuals and other doc only speak about visiting a file in a bu [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Drew Adams writes: > Please consider improving the doc so that it does the following: > > * Explains what is meant by "visiting" a Dired buffer. The Emacs > manuals and other doc only speak about visiting a file in a bu [...] Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.0 SPF_NONE SPF: sender does not publish an SPF Record 0.0 URIBL_BLOCKED ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [URIs: ingebrigtsen.no] 1.3 RDNS_NONE Delivered to internal network by a host with no rDNS X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) Drew Adams writes: > Please consider improving the doc so that it does the following: > > * Explains what is meant by "visiting" a Dired buffer. The Emacs > manuals and other doc only speak about visiting a file in a buffer. > Just what constitutes "visiting" a Dired buffer? It seems like it's > sufficient to display the buffer and select its window. Is that it? It means whatever Emacs means by "visiting" a file. I don't see what's there to explain. > * Explains the Value Menu items in Customize - in particular, item > `Revert changed Dired buffer'. Explaining what "revert" means in this context seems a bit odd. There's a manual for that. > * Explains that the option has no effect on Dired buffers containing > arbitrary file lists (i.e., whose DIRNAME is a cons). It is relevant > only for actual directory listings. You mean that switching it off doesn't stop reverting in that case? ;; Always revert when `dir-or-list' is a cons. Also revert ;; if `dired-directory' is a cons but `dir-or-list' is not. ((or (consp dir-or-list) (consp dired-directory)) (setq dired-directory dir-or-list) (revert-buffer)) ;; Always revert regardless of whether it has changed or not. ((eq dired-auto-revert-buffer t) (revert-buffer)) As far as I can tell, this is only reached when you call `dired' explicitly with a list of file names? That dired updates the buffer when you call it with a bunch of file names, without consulting dired-auto-revert-buffer, seems pretty self-evident. > * Lists the Lisp values that correspond to the Value Menu items. They all seem documented? (const :tag "Revert changed Dired buffer" dired-directory-changed-p) is just a predicate function. Didn't see anything that needed fixing here, and I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 16 22:57:57 2019 Received: (at control) by debbugs.gnu.org; 17 Oct 2019 02:57:57 +0000 Received: from localhost ([127.0.0.1]:46873 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKvzB-0007b7-3D for submit@debbugs.gnu.org; Wed, 16 Oct 2019 22:57:57 -0400 Received: from [80.91.231.51] (port=43448 helo=quimby.gnus.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iKvz9-0007az-Rv for control@debbugs.gnu.org; Wed, 16 Oct 2019 22:57:56 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iKvz7-0004ST-0Q for control@debbugs.gnu.org; Thu, 17 Oct 2019 04:57:55 +0200 Date: Thu, 17 Oct 2019 04:57:52 +0200 Message-Id: <87y2xkkrin.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #37771 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 37771 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: close 37771 quit Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.0 SPF_NONE SPF: sender does not publish an SPF Record 1.3 RDNS_NONE Delivered to internal network by a host with no rDNS X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) close 37771 quit From unknown Mon Aug 18 08:26:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#37771: 26.3; doc for `dired-auto-revert-buffer' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Oct 2019 15:37:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37771 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: 37771@debbugs.gnu.org Received: via spool by 37771-submit@debbugs.gnu.org id=B37771.157132659331655 (code B ref 37771); Thu, 17 Oct 2019 15:37:01 +0000 Received: (at 37771) by debbugs.gnu.org; 17 Oct 2019 15:36:33 +0000 Received: from localhost ([127.0.0.1]:48741 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iL7pI-0008EV-SO for submit@debbugs.gnu.org; Thu, 17 Oct 2019 11:36:33 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:56896) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iL7pG-0008EI-N2 for 37771@debbugs.gnu.org; Thu, 17 Oct 2019 11:36:31 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x9HFYNYr012987; Thu, 17 Oct 2019 15:36:24 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=SwEwXISbY+2+a6cAEKDD28ZZlkSb2UXRuQP5ccgln2o=; b=JwJVyrHInbeQN4Dag35WjlD42H5289YVCW3FrZunxEZMteKzPnDVRl7wLLeXCGN2iKbp UYy54J/G8T8s3IRjK2zbfarnLziT4PqM2826bG6bJbwgzx5HGTVK7II/iuZKcCoV8q3R Ex+lGs7TKatqCZfRAzy8BNWdzpeF0qfrulaZyj7UL15QPvSIiYcicB4gJ3qdr7DrKwgp ZzedJr6e+W53cilCUId1srprQ63l9fd9yefRLm10LlnO3+96rKH3aCaMXSQFcvEzKuuZ ud8vJPnSL6iS31yLEz7JNvBv7Se66gArQCUNuE8A23qPlEEl7xMrxPPmTVMGetHyGaTd wQ== Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2120.oracle.com with ESMTP id 2vk7frq2px-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 17 Oct 2019 15:36:24 +0000 Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x9HFX7dF137835; Thu, 17 Oct 2019 15:34:23 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3030.oracle.com with ESMTP id 2vpcm34hk2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 17 Oct 2019 15:34:23 +0000 Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x9HFYL1p024121; Thu, 17 Oct 2019 15:34:21 GMT MIME-Version: 1.0 Message-ID: <6ef7235b-4091-437c-87da-46ad883cb235@default> Date: Thu, 17 Oct 2019 15:34:20 +0000 (UTC) From: Drew Adams References: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> <87zhi0krit.fsf@gnus.org> In-Reply-To: <87zhi0krit.fsf@gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9413 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910170139 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9413 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910170139 X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > Please consider improving the doc so that it does the following: > > > > * Explains what is meant by "visiting" a Dired buffer. The Emacs > > manuals and other doc only speak about visiting a file in a buffer. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > Just what constitutes "visiting" a Dired buffer? It seems like > > it's sufficient to display the buffer and select its window. > > Is that it? >=20 > It means whatever Emacs means by "visiting" a file. I don't see what's > there to explain. Why do you think so? Nowhere in our doc do we introduce a notion of "visiting" a buffer. And a Dired buffer is not a file. Isn't what's really meant only that the buffer is displayed and its window is selected? If so, say so. That's a far cry from visiting a file. > > * Explains the Value Menu items in Customize - in particular, item > > `Revert changed Dired buffer'. >=20 > Explaining what "revert" means in this context seems a bit odd. > There's a manual for that. No. Buffer reverting is particular to different kinds of buffer (apart from file buffers, where it acts about the same for any file). So explain what it means to revert a Dired buffer. And yes, it means something particular. > > * Explains that the option has no effect on Dired buffers containing > > arbitrary file lists (i.e., whose DIRNAME is a cons). It is > > relevant only for actual directory listings. >=20 > You mean that switching it off doesn't stop reverting in that case? Switching what off? I don't know what you mean here. The point is that reverting a Dired buffer means one thing for a file listing (ordinary use of Dired). It means something else when the buffer has any an arbitrary list of files (e.g. from different dirs that are not just subdirs). In such cases IF reverting is possible its behavior can be particular to the particular kind of listing. And this variable does not apply - its value has no effect.=20 > =09 ;; Always revert when `dir-or-list' is a cons. Also revert > =09 ;; if `dired-directory' is a cons but `dir-or-list' is not. > =09 ((or (consp dir-or-list) (consp dired-directory)) > =09 (setq dired-directory dir-or-list) > =09 (revert-buffer)) > =09 ;; Always revert regardless of whether it has changed or not. > =09 ((eq dired-auto-revert-buffer t) > =09 (revert-buffer)) >=20 > As far as I can tell, this is only reached when you call `dired' > explicitly with a list of file names? That dired updates the buffer > when you call it with a bunch of file names, without consulting > dired-auto-revert-buffer, seems pretty self-evident. Self-evident from the code. The point is that the _doc_ for the variable should say that it has no effect in such cases - it applies only to ordinary file listings, such as produced by `ls'. > > * Lists the Lisp values that correspond to the Value Menu items. >=20 > They all seem documented? No. This one is not: "Revert changed Dired buffer". > "Revert changed Dired buffer" dired-directory-changed-p) > is just a predicate function. Of course it is. But it is a particular, predefined predicate, which corresponds to one of the menu items. This is no different from when we have menu items that correspond to other particular values. We document them. Users should be able to see the correspondence between the documented Lisp values and the menu items. > Didn't see anything that needed fixing here, and I'm closing this bug > report. Unfortunate. From unknown Mon Aug 18 08:26:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#37771: 26.3; doc for `dired-auto-revert-buffer' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Oct 2019 17:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37771 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 37771@debbugs.gnu.org Received: via spool by 37771-submit@debbugs.gnu.org id=B37771.15713321099175 (code B ref 37771); Thu, 17 Oct 2019 17:09:01 +0000 Received: (at 37771) by debbugs.gnu.org; 17 Oct 2019 17:08:29 +0000 Received: from localhost ([127.0.0.1]:48868 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iL9GG-0002Ns-UX for submit@debbugs.gnu.org; Thu, 17 Oct 2019 13:08:29 -0400 Received: from eggs.gnu.org ([209.51.188.92]:36953) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iL9GE-0002NZ-58 for 37771@debbugs.gnu.org; Thu, 17 Oct 2019 13:08:27 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:41985) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iL9G8-00043W-TX; Thu, 17 Oct 2019 13:08:20 -0400 Received: from [176.228.60.248] (port=2766 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iL9G8-0000Ke-7o; Thu, 17 Oct 2019 13:08:20 -0400 Date: Thu, 17 Oct 2019 20:08:03 +0300 Message-Id: <83o8yf9u6k.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> (message from Drew Adams on Tue, 15 Oct 2019 15:35:05 -0700 (PDT)) References: <60cfbdb5-8f92-4af6-bf5a-f1f7f05bd1c6@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Tue, 15 Oct 2019 15:35:05 -0700 (PDT) > From: Drew Adams > > Please consider improving the doc so that it does the following: Thanks, fixed.