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: "Drew Adams" <drew.adams <at> oracle.com>
Subject: bug#907 closed by Chong Yidong <cyd <at> stupidchicken.com> (Re: 
 23.0.60; doc string for dired-do-create-files)

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

This is an automatic notification regarding your bug report
which was filed against the emacs package:

#907: 23.0.60; doc string for dired-do-create-files

It has been closed by Chong Yidong <cyd <at> stupidchicken.com>.

Their explanation is attached below along with your original report.
If this explanation is unsatisfactory and you have not received a
better one in a separate message then please contact Chong Yidong <cyd <at> stupidchicken.com> by
replying to this email.


-- 
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: 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.

[Message part 3 (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'
 

Previous Next

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