From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#28963: 24.5; doc string of `dired-find-alternate-file' Date: Mon, 23 Oct 2017 19:07:02 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1508810896 28922 195.159.176.226 (24 Oct 2017 02:08:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 24 Oct 2017 02:08:16 +0000 (UTC) To: 28963@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 24 04:08:12 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 1e6odS-0006Iw-2U for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Oct 2017 04:08:06 +0200 Original-Received: from localhost ([::1]:41325 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e6odZ-0001L9-6L for geb-bug-gnu-emacs@m.gmane.org; Mon, 23 Oct 2017 22:08:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57538) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e6odR-0001Kl-S5 for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:08:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e6odO-0007VJ-NR for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:08:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49496) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1e6odO-0007V8-Jk for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:08:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1e6odO-00070D-BJ for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Oct 2017 02:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 28963 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.150881084026864 (code B ref -1); Tue, 24 Oct 2017 02:08:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 Oct 2017 02:07:20 +0000 Original-Received: from localhost ([127.0.0.1]:58177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e6och-0006zE-Q1 for submit@debbugs.gnu.org; Mon, 23 Oct 2017 22:07:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38233) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e6ocf-0006z1-B1 for submit@debbugs.gnu.org; Mon, 23 Oct 2017 22:07:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e6ocZ-00072T-BM for submit@debbugs.gnu.org; Mon, 23 Oct 2017 22:07:12 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50451) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1e6ocZ-00072N-7S for submit@debbugs.gnu.org; Mon, 23 Oct 2017 22:07:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57432) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e6ocY-0001II-7s for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:07:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e6ocV-0006zn-3G for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:07:10 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:39692) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1e6ocU-0006zV-SC for bug-gnu-emacs@gnu.org; Mon, 23 Oct 2017 22:07:07 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v9O274Ko012066 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 24 Oct 2017 02:07:05 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v9O274jC032260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 24 Oct 2017 02:07:04 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v9O273eM019037 for ; Tue, 24 Oct 2017 02:07:03 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4600.0 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:138916 Archived-At: 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". It shouldn't be _necessary_ to keep the doc string to a minimum and only reference `find-alternate-file'. But if there is no desire to provide the kind of info we provide for `find-alternate-file' then it would be fine to just reference that function's doc. In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32'