From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#28963: 24.5; doc string of `dired-find-alternate-file' Date: Fri, 27 Oct 2017 17:59:01 +0300 Message-ID: <8360b07i2y.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1509116432 8424 195.159.176.226 (27 Oct 2017 15:00:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 27 Oct 2017 15:00:32 +0000 (UTC) Cc: 28963-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Oct 27 17:00:27 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e867L-0000PU-7p for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Oct 2017 17:00:15 +0200 Original-Received: from localhost ([::1]:57730 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e867R-0006PT-0W for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Oct 2017 11:00:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46451) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e867D-0006Kl-1N for bug-gnu-emacs@gnu.org; Fri, 27 Oct 2017 11:00:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e8679-0004ey-51 for bug-gnu-emacs@gnu.org; Fri, 27 Oct 2017 11:00:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:57069) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1e8679-0004eo-1d for bug-gnu-emacs@gnu.org; Fri, 27 Oct 2017 11:00:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1e8678-0003E2-OB for bug-gnu-emacs@gnu.org; Fri, 27 Oct 2017 11:00:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 27 Oct 2017 15:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 28963 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 28963@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 28963-done@debbugs.gnu.org id=D28963.150911636012293 (code D ref 28963); Fri, 27 Oct 2017 15:00:02 +0000 Original-Received: (at 28963-done) by debbugs.gnu.org; 27 Oct 2017 14:59:20 +0000 Original-Received: from localhost ([127.0.0.1]:37516 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e866S-0003CD-K3 for submit@debbugs.gnu.org; Fri, 27 Oct 2017 10:59:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55198) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e866R-0003Bx-HW for 28963-done@debbugs.gnu.org; Fri, 27 Oct 2017 10:59:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e866I-00042b-Ix for 28963-done@debbugs.gnu.org; Fri, 27 Oct 2017 10:59:14 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59087) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e866I-00042Q-FO; Fri, 27 Oct 2017 10:59:10 -0400 Original-Received: from [176.228.60.248] (port=3644 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1e866H-0008QR-Ne; Fri, 27 Oct 2017 10:59:10 -0400 In-reply-to: (message from Drew Adams on Mon, 23 Oct 2017 19:07:02 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:139081 Archived-At: > Date: Mon, 23 Oct 2017 19:07:02 -0700 (PDT) > From: Drew Adams > > This doc string needs improvement: > > In Dired, visit this file or directory instead of the Dired buffer. > > The real meaning depends on what one understands by "instead of the > Dired buffer". Many users will likely (mis)understand only that the > file or directory is visited in place of the current Dired buffer. > They won't understand that the current buffer will be killed. > > If the idea is to keep the doc string short, it would be far more > helpful to say that it uses `find-alternate-file', because that command > has much better documentation. In particular, it says explicitly: "kill > previous buffer". I did both, thanks.