RE: doc string of dired-do-kill-lines, "killing" lines in Dired

[Drew Adams]

> > 1. The last two sentences seem redundant, to me:
> >  
> >  If you use this command with a prefix argument to kill the line
> >  for a file that is a directory, which you have inserted in the
> >  Dired buffer as a subdirectory, then it deletes that subdirectory
> >  from the buffer as well.
> >  To kill an entire subdirectory (without killing its line in the
>                                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >  parent directory), go to its directory header line and use this
>    ^^^^^^^^^^^^^^^^^
> >  command with a prefix argument (the value does not matter).
> >  
> > These sentences both seem to be saying only that `C-u k' on a subdir
> > header line deletes the subdir listing (all files). Just say that
> > (once).
> 
> They are two different operations, the latter deleting one line less.

This is unclear: "the line for a file that is a directory, which you have
inserted in the Dired buffer as a subdirectory". I thought that was trying
to refer to a subdir header line. Please rephrase the text to make the
difference clear.

Suggestion: start by using simple, short sentences.