From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#11534: 24.0.97; `dired-get-marked-files' does not behave as documented Date: Mon, 21 May 2012 11:31:02 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1337625155 4972 80.91.229.3 (21 May 2012 18:32:35 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 21 May 2012 18:32:35 +0000 (UTC) To: 11534@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon May 21 20:32:34 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SWXPC-0000Zs-SU for geb-bug-gnu-emacs@m.gmane.org; Mon, 21 May 2012 20:32:31 +0200 Original-Received: from localhost ([::1]:45355 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXPC-00030j-D9 for geb-bug-gnu-emacs@m.gmane.org; Mon, 21 May 2012 14:32:30 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:39262) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXP9-00030Q-HN for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:32:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWXP7-0008PN-I5 for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:32:27 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56249) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXP7-0008PE-EE for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:32:25 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SWXPi-000638-94 for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:33:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 21 May 2012 18:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11534 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.133762514023205 (code B ref -1); Mon, 21 May 2012 18:33:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 May 2012 18:32:20 +0000 Original-Received: from localhost ([127.0.0.1]:37562 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SWXP1-00062B-Mi for submit@debbugs.gnu.org; Mon, 21 May 2012 14:32:19 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:51790) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SWXOh-00061H-DH for submit@debbugs.gnu.org; Mon, 21 May 2012 14:32:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWXNx-0007yQ-GB for submit@debbugs.gnu.org; Mon, 21 May 2012 14:31:14 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:52197) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXNx-0007yJ-DB for submit@debbugs.gnu.org; Mon, 21 May 2012 14:31:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38872) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXNv-0001XP-Of for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:31:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWXNs-0007vb-VS for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:31:11 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:34873) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWXNs-0007ub-Pz for bug-gnu-emacs@gnu.org; Mon, 21 May 2012 14:31:08 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4LIV4iH012557 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 21 May 2012 18:31:05 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4LIV3xr024155 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 21 May 2012 18:31:04 GMT Original-Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4LIV3w7020323 for ; Mon, 21 May 2012 13:31:03 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 21 May 2012 11:31:03 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac03f+AizLdFTULoTyew2GAzFEpm9g== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:60265 Archived-At: emacs -Q Put point on any file line. M-: (dired-get-marked-files) It returns the name of that line's file. But the doc string says this about argument ARG, which is nil in this case: Optional second argument ARG, if non-nil, specifies files near point instead of marked files. It usually comes from the prefix argument. If ARG is an integer, use the next ARG files. Any other non-nil value means to use the current file instead. It does not explicitly say anything about what happens when ARG is nil (and no files are marked). But a reader could reasonably assume that none of what happens when ARG is non-nil would happen. In particular, this line: Any other non-nil value means to use the current file instead. gives the impression that the current file will not be used if ARG is nil. Otherwise, it makes little sense to say "any non-nil value" and to put this sentence under the guard of "Optional second argument ARG, if non-nil...". Should the behavior be as is documented, which would reasonably mean that no file name is returned (nil is returned)? Or should the doc string be corrected to reflect the actual behavior, i.e., the fact that ARG = nil means return only the current file name when none are marked? In GNU Emacs 24.0.97.1 (i386-mingw-nt5.1.2600) of 2012-05-16 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include'