From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#916: 23.0.60; doc string of dired-get-marked-files Date: Sun, 7 Sep 2008 10:17:10 -0700 Message-ID: <001d01c9110d$9062a240$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 916@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1220808471 25679 80.91.229.12 (7 Sep 2008 17:27:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 7 Sep 2008 17:27:51 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 07 19:28:46 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1KcO44-0002TE-GE for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Sep 2008 19:28:44 +0200 Original-Received: from localhost ([127.0.0.1]:42996 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KcO34-0001MZ-Do for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Sep 2008 13:27:42 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KcO30-0001MU-V3 for bug-gnu-emacs@gnu.org; Sun, 07 Sep 2008 13:27:38 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KcO2w-0001MI-EZ for bug-gnu-emacs@gnu.org; Sun, 07 Sep 2008 13:27:37 -0400 Original-Received: from [199.232.76.173] (port=58818 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KcO2w-0001MF-8K for bug-gnu-emacs@gnu.org; Sun, 07 Sep 2008 13:27:34 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:39383) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KcO2v-0001VU-PT for bug-gnu-emacs@gnu.org; Sun, 07 Sep 2008 13:27:34 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m87HRWIU031404; Sun, 7 Sep 2008 10:27:32 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m87HP5Fq030174; Sun, 7 Sep 2008 10:25:05 -0700 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 07 Sep 2008 17:25:05 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 916 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.122080784328093 (code B ref -1); Sun, 07 Sep 2008 17:25:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 7 Sep 2008 17:17:23 +0000 Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m87HHKxj028087 for ; Sun, 7 Sep 2008 10:17:21 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:59742 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1KcNrM-0005Bq-1N for emacs-pretest-bug@gnu.org; Sun, 07 Sep 2008 13:15:36 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1KcNsx-0008M3-J1 for emacs-pretest-bug@gnu.org; Sun, 07 Sep 2008 13:17:19 -0400 Original-Received: from agminet01.oracle.com ([141.146.126.228]:34807) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KcNsx-0008Lp-5P for emacs-pretest-bug@gnu.org; Sun, 07 Sep 2008 13:17:15 -0400 Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m87HHBhp001230 for ; Sun, 7 Sep 2008 12:17:12 -0500 Original-Received: from acsmt700.oracle.com (acsmt700.oracle.com [141.146.40.70]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m87HH9HF021240 for ; Sun, 7 Sep 2008 11:17:09 -0600 Original-Received: from dradamslap1 (/24.23.165.218) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 07 Sep 2008 10:17:09 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckRDY/+pvUIgq81Su+bynYFGKbcYw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) Resent-Date: Sun, 07 Sep 2008 13:27:37 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:20292 gmane.emacs.pretest.bugs:23005 Archived-At: The doc string says this about optional arg ARG: Optional second argument arg specifies files near point instead of marked files. If arg is an integer, use the next arg files. If arg is otherwise non-nil, use file. Usually arg comes from the command's prefix arg. This is not correct, or at least it is incomplete. It says that the current file is used if ARG is non-nil but not an integer, which is true, but it suggests that no file is used if ARG is nil. That is, the entire ARG description suggests that a singleton list of the current file is returned only when ARG is non-nil. It suggests that if ARG is nil then the empty list is returnedl. In fact, if ARG is nil, the current file is used. That is, (dired-get-marked-files) in Dired returns the singleton list of the file where the cursor is. This behavior is not a bug; it is the doc string that is incomplete by not covering this case. The doc string should say something like this regarding ARG: Optional second argument arg specifies files near point instead of marked files. If arg is an integer, use the next arg files. Otherwise, use the file on the current line. Usually arg comes from the command's prefix arg. `dired-get-marked-files' uses `dired-map-over-marks', and the doc string of that function correctly states "If no marked file could be found, execute body on the current line." In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-08-29 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping'