GNU bug report logs - #907
23.0.60; doc string for dired-do-create-files

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (Emacs bug Tracking System)
To: Chong Yidong <cyd <at> stupidchicken.com>
Subject: bug#907: marked as done (23.0.60; doc string for dired-do-create-files)

[Message part 1 (text/plain, inline)]

Your message dated Wed, 22 Oct 2008 16:21:49 -0400
with message-id <87wsg0bcte.fsf <at> cyd.mit.edu>
and subject line Re: 23.0.60; doc string for dired-do-create-files
has caused the Emacs bug report #907,
regarding 23.0.60; doc string for dired-do-create-files
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact don <at> donarmstrong.com
immediately.)


-- 
907: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=907
Emacs Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.60; doc string for dired-do-create-files
Date: Sat, 6 Sep 2008 15:31:51 -0700

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'
 

[Message part 3 (message/rfc822, inline)]

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 907-done <at> debbugs.gnu.org
Subject: Re: 23.0.60; doc string for dired-do-create-files
Date: Wed, 22 Oct 2008 16:21:49 -0400

> 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?

Fixed, thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.