[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110782: * dired.texi (Dired Updating): Doc fix.

[Chong Yidong]

------------------------------------------------------------
revno: 110782
fixes bug: http://debbugs.gnu.org/11744
committer: Chong Yidong <address@hidden>
branch nick: emacs-24
timestamp: Mon 2012-11-05 22:13:26 +0800
message:
  * dired.texi (Dired Updating): Doc fix.
modified:
  doc/emacs/ChangeLog
  doc/emacs/dired.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-10-30 12:48:42 +0000
+++ b/doc/emacs/ChangeLog       2012-11-05 14:13:26 +0000
@@ -1,3 +1,7 @@
+2012-11-05  Chong Yidong  <address@hidden>
+
+       * dired.texi (Dired Updating): Doc fix (Bug#11744).
+
 2012-10-30  Michael Albinus  <address@hidden>
 
        * trouble.texi (Known Problems): Mention command `debbugs-gnu-usertags'.

=== modified file 'doc/emacs/dired.texi'
--- a/doc/emacs/dired.texi      2012-10-29 23:48:02 +0000
+++ b/doc/emacs/dired.texi      2012-11-05 14:13:26 +0000
@@ -1170,17 +1170,17 @@
 
 @kindex k @r{(Dired)}
 @findex dired-do-kill-lines
-  To delete the specified @emph{file lines} from the buffer---not
-delete the files---type @kbd{k} (@code{dired-do-kill-lines}).  Like
+  To delete @emph{file lines} from the buffer---without actually
+deleting the files---type @kbd{k} (@code{dired-do-kill-lines}).  Like
 the file-operating commands, this command operates on the next @var{n}
-files, or on the marked files if any; but it does not operate on the
-current file as a last resort.
+files, or on the marked files if any.  However, it does not operate on
+the current file, since otherwise mistyping @kbd{k} could be annoying.
 
-  If you use @kbd{k} with a numeric prefix argument to kill the line
-for a file that is a directory, which you have inserted in the Dired
-buffer as a subdirectory, it removed that subdirectory line from the
-buffer as well.  Typing @kbd{C-u k} on the header line for a
-subdirectory also removes the subdirectory line from the Dired buffer.
+  If you use @kbd{k} to kill the line for a directory file which you
+had inserted in the Dired buffer as a subdirectory
+(@pxref{Subdirectories in Dired}), it removes the subdirectory listing
+as well.  Typing @kbd{C-u k} on the header line for a subdirectory
+also removes the subdirectory line from the Dired buffer.
 
   The @kbd{g} command brings back any individual lines that you have
 killed in this way, but not subdirectories---you must use @kbd{i} to