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#11553: 24.0.97; doc string of `dired-mark-read-string' Date: Thu, 24 May 2012 11:39:34 -0700 Message-ID: <4358B39464054AA091163961CA5957A6@us.oracle.com> References: <49EDCA00FEBE4FDD8F5D2F934863D6AE@us.oracle.com> 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 1337884879 14213 80.91.229.3 (24 May 2012 18:41:19 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 24 May 2012 18:41:19 +0000 (UTC) To: <11553@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu May 24 20:41:19 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 1SXcyF-0004gJ-Gh for geb-bug-gnu-emacs@m.gmane.org; Thu, 24 May 2012 20:41:11 +0200 Original-Received: from localhost ([::1]:57850 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SXcyF-0002ul-3v for geb-bug-gnu-emacs@m.gmane.org; Thu, 24 May 2012 14:41:11 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60090) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SXcyC-0002uL-70 for bug-gnu-emacs@gnu.org; Thu, 24 May 2012 14:41:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SXcyA-0007GG-FF for bug-gnu-emacs@gnu.org; Thu, 24 May 2012 14:41:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:32853) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SXcyA-0007GA-Bx for bug-gnu-emacs@gnu.org; Thu, 24 May 2012 14:41:06 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SXcz4-00059n-3v for bug-gnu-emacs@gnu.org; Thu, 24 May 2012 14:42: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: Thu, 24 May 2012 18:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11553 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11553-submit@debbugs.gnu.org id=B11553.133788486619755 (code B ref 11553); Thu, 24 May 2012 18:42:02 +0000 Original-Received: (at 11553) by debbugs.gnu.org; 24 May 2012 18:41:06 +0000 Original-Received: from localhost ([127.0.0.1]:42399 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SXcy6-00058M-Al for submit@debbugs.gnu.org; Thu, 24 May 2012 14:41:05 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:41259) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SXcxk-00057e-Pt for 11553@debbugs.gnu.org; Thu, 24 May 2012 14:41:00 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4OIdcvR019093 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <11553@debbugs.gnu.org>; Thu, 24 May 2012 18:39:39 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4OIdbvb001535 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <11553@debbugs.gnu.org>; Thu, 24 May 2012 18:39:38 GMT Original-Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4OIdb29000875 for <11553@debbugs.gnu.org>; Thu, 24 May 2012 13:39:37 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 24 May 2012 11:39:37 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <49EDCA00FEBE4FDD8F5D2F934863D6AE@us.oracle.com> Thread-Index: Ac052t//c0s1kCcwQvq43JqbnnXigAAAF63w X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] 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:60340 Archived-At: > 1. "ARG is normally the prefix argument for the calling command." > > So what? That doesn't tell you anything useful. What is ARG > for? What does it do? Just say that it is passed to > `dired-mark-prompt'. Things are even worse than I thought. The doc string of `dired-mark-prompt' punts just as pitifully as that for `dired-mark-read-string' - the wording is even the same. What should be said about ARG and FILES for `dired-mark-prompt': "If ARG is nil then prompt to act on the number of files in FILES. If non-nil then prompt to act on the next N files, where N is the `prefix-numeric-value' of ARG." "FILES is the same as in `dired-mark-pop-up'." (or repeat the definition of FILES from `dired-mark-pop-up')