Re: `k' in Dired with inserted subdirectories.

[Luc Teirlinck]

Richard Stallman wrote:

         If you use this command with a prefix argument to kill the
         line for a subdirectory, and you've dispayed the subdirectory
         contents in the buffer with \\[dired-insert-subdir], it kills
         the subdirectory's lines too.

   "with \\[dired-insert-subdir]" is a more precise and clear way to identify
   the case in question than any description could be.

(This concerns the `dired-do-kill-lines' docstring.)

I have two problems with the above:

"the line for a subdirectory" could be misunderstood as the
subdirectory header line and "\\[dired-insert-subdir]" is going to
come out as `M-x dired-insert-subdir', unless C-h f was issued from a
Dired buffer.  This might look cryptic to non-Elisp users, thinking of
this as `i'.  \\<dired-mode-map>\\[dired-insert-subdir] is going to
come out worse if dired is not yet loaded.

What about:

If you use this command with a prefix argument to kill the line for
a file that is a directory, which the Dired buffer also displays as
a subdirectory, then it deletes that subdirectory from the buffer
as well.