From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel,gmane.emacs.pretest.bugs Subject: 23.0.60; doc of dired-read-shell-command Date: Fri, 11 Apr 2008 07:48:46 -0700 Message-ID: <002301c89be3$25ce2ed0$0200a8c0@us.oracle.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 1207925349 28692 80.91.229.12 (11 Apr 2008 14:49:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 11 Apr 2008 14:49:09 +0000 (UTC) To: Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 11 16:49:42 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JkKZR-0003qm-Vd for ged-emacs-devel@m.gmane.org; Fri, 11 Apr 2008 16:49:42 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JkKYo-0000vm-1H for ged-emacs-devel@m.gmane.org; Fri, 11 Apr 2008 10:49:02 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JkKYj-0000vT-UR for emacs-devel@gnu.org; Fri, 11 Apr 2008 10:48:57 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JkKYj-0000v3-0L for emacs-devel@gnu.org; Fri, 11 Apr 2008 10:48:57 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JkKYi-0000uw-Q4 for emacs-devel@gnu.org; Fri, 11 Apr 2008 10:48:56 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JkKYi-00076N-HD for emacs-devel@gnu.org; Fri, 11 Apr 2008 10:48:56 -0400 Original-Received: from mail.gnu.org ([199.232.76.166] helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1JkKYi-0000Ax-8N for emacs-pretest-bug@gnu.org; Fri, 11 Apr 2008 10:48:56 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1JkKYd-00075J-UJ for emacs-pretest-bug@gnu.org; Fri, 11 Apr 2008 10:48:55 -0400 Original-Received: from rgminet01.oracle.com ([148.87.113.118]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JkKYd-00074x-Iv for emacs-pretest-bug@gnu.org; Fri, 11 Apr 2008 10:48:51 -0400 Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m3BEmn1B001493 for ; Fri, 11 Apr 2008 08:48:49 -0600 Original-Received: from acsmt350.oracle.com (acsmt350.oracle.com [141.146.40.150]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m3A4ng9C029905 for ; Fri, 11 Apr 2008 08:48:48 -0600 Original-Received: from inet-141-146-46-1.oracle.com by acsmt350.oracle.com with ESMTP id 3646538861207925327; Fri, 11 Apr 2008 07:48:47 -0700 Original-Received: from dradamslap1 (/141.144.88.79) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 11 Apr 2008 07:48:46 -0700 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 Thread-Index: Acib4yVqNoTD+ZehSayw8CMZ3owWAQ== 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, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:94967 gmane.emacs.pretest.bugs:21975 Archived-At: 1. The dired-x.el version of the function has this doc string: "Read a dired shell command prompting with PROMPT (using read-string). ARG is the prefix arg and may be used to indicate in the prompt which files are affected. This is an extra function so that you can redefine it." What is that last line supposed to mean? What does "extra function" mean? And why is dired-x.el permitted to redefine the function? 2. The dired-aux.el version of the function has no doc string. It has a comment that says almost the same thing, but no doc string. These descriptions and the intention regarding redefinition are not clear. At the very least, both functions should have doc strings, and the doc strings should be clear. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-04-04 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'