GNU bug report logs - #7125
24.0.50; (emacs)Subdirectories in Dired - incorrect doc

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 7125 in the body.
You can then email your comments to 7125 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.0.50; (emacs)Subdirectories in Dired - incorrect doc
Date: Tue, 28 Sep 2010 14:27:55 -0700 (PDT)

Node (emacs)Subdirectories in Dired says this, which is incorrect:
 
"Use `C-u k' on the subdirectory header line
to delete the subdirectory (*note Dired Updating::)."
 
It should say that `C-u k' on a subdirectory header line removes the
subdirectory listing.  It does NOT DELETE the subdirectory itself 
(thank goodness).
 
Also, it needs to say more than this. It should distinguish the `C-u k'
behavior on a subdirectory line in the main dir listing from its
behavior on the subdir header line of its own listing.  Both behaviors
need to be described. 
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2010-09-20 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'
 

Message #8 received at 7125 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 7125 <at> debbugs.gnu.org
Subject: Re: bug#7125: 24.0.50; (emacs)Subdirectories in Dired - incorrect doc
Date: Sat, 02 Jul 2011 16:23:31 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> "Use `C-u k' on the subdirectory header line
> to delete the subdirectory (*note Dired Updating::)."
>
> It should say that `C-u k' on a subdirectory header line removes the
> subdirectory listing.  It does NOT DELETE the subdirectory itself 
> (thank goodness).
>
> Also, it needs to say more than this. It should distinguish the `C-u k'
> behavior on a subdirectory line in the main dir listing from its
> behavior on the subdir header line of its own listing.  Both behaviors
> need to be described. 

Could you describe the two different behaviours?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #11 received at 7125 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 7125 <at> debbugs.gnu.org
Subject: RE: bug#7125: 24.0.50; (emacs)Subdirectories in Dired - incorrect doc
Date: Sat, 2 Jul 2011 08:34:58 -0700

> > Also, it needs to say more than this. It should distinguish 
> > the `C-u k' behavior on a subdirectory line in the main dir
> > listing from its behavior on the subdir header line of its
> > own listing.  Both behaviors need to be described. 
> 
> Could you describe the two different behaviours?

See the doc string; it does a pretty good job:
`C-h k k' (in Dired).

Message #18 received at 7125 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 7125 <at> debbugs.gnu.org
Subject: Re: bug#7125: 24.0.50; (emacs)Subdirectories in Dired - incorrect doc
Date: Sat, 02 Jul 2011 17:44:41 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> See the doc string; it does a pretty good job:
> `C-h k k' (in Dired).

Right.  I've now clarified that paragraph in the "Subdirectories in
Dired" node, but I haven't mentioned the detail about the header line
there, since it's explained in more detail in the "Dired Updating" node.
And I've clarified that it doesn't delete anything there, too.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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