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#907: 23.0.60; doc string for dired-do-create-files Date: Sat, 6 Sep 2008 15:31:51 -0700 Message-ID: <000501c91070$5bc6b320$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 907@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 1220741272 21655 80.91.229.12 (6 Sep 2008 22:47:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Sep 2008 22:47:52 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 07 00:48:47 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 1Kc6aC-0000Z3-5G for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Sep 2008 00:48:44 +0200 Original-Received: from localhost ([127.0.0.1]:56801 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kc6ZB-0004l7-M9 for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Sep 2008 18:47:41 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Kc6Z5-0004kO-Pn for bug-gnu-emacs@gnu.org; Sat, 06 Sep 2008 18:47:35 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Kc6Z4-0004kB-5z for bug-gnu-emacs@gnu.org; Sat, 06 Sep 2008 18:47:35 -0400 Original-Received: from [199.232.76.173] (port=35712 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kc6Z4-0004k8-1E for bug-gnu-emacs@gnu.org; Sat, 06 Sep 2008 18:47:34 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:52520) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Kc6Z3-0003Gl-G3 for bug-gnu-emacs@gnu.org; Sat, 06 Sep 2008 18:47:33 -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 m86MlV3w022443; Sat, 6 Sep 2008 15:47:32 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m86Me4dw019474; Sat, 6 Sep 2008 15:40:04 -0700 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sat, 06 Sep 2008 22:40:04 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 907 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.122074032617207 (code B ref -1); Sat, 06 Sep 2008 22:40:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 6 Sep 2008 22:32:06 +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 m86MW2EP017201 for ; Sat, 6 Sep 2008 15:32:03 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:49638 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1Kc6IN-0007Dx-LF for emacs-pretest-bug@gnu.org; Sat, 06 Sep 2008 18:30:19 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Kc6Jx-0001gq-59 for emacs-pretest-bug@gnu.org; Sat, 06 Sep 2008 18:32:01 -0400 Original-Received: from rgminet01.oracle.com ([148.87.113.118]:29874) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Kc6Jw-0001gV-DR for emacs-pretest-bug@gnu.org; Sat, 06 Sep 2008 18:31:56 -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 m86MVr1f020284 for ; Sat, 6 Sep 2008 16:31:54 -0600 Original-Received: from acsmt702.oracle.com (acsmt702.oracle.com [141.146.40.80]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m86MVqrM017002 for ; Sat, 6 Sep 2008 16:31:52 -0600 Original-Received: from dradamslap1 (/24.23.165.218) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 06 Sep 2008 15:31:52 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckQcFtl1AugDqtITgGm63JRzsijQA== 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: Sat, 06 Sep 2008 18:47:35 -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:20263 gmane.emacs.pretest.bugs:23000 Archived-At: emacs -Q Same problem exists in Emacs 22.2, BTW. The doc string of dired-do-create-files refers several times to `into-dir' (without quotes or uppercase). Nowhere is there any explanation of what is mean by this, however. Presumably, it is either a global variable or an argument? This renders the doc string incomprehensible. About 2/3 of the doc string concerns `into-dir', and it includes a seemingly ridiculously complex explanation of arg HOW-TO, complete with if-then-else-if-then-else-if-then-else-if-then-else (no exaggeration!). Please rewrite the doc string so that it is self-contained and readable. It should not simply mirror the code but should make clear to users what each argument is. 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'