[Emacs-diffs] /srv/bzr/emacs/trunk r104846: * dired.el (dired-mode): Fix up the doc string as suggested by

[Lars Magne Ingebrigtsen]

------------------------------------------------------------
revno: 104846
fixes bug(s): http://debbugs.gnu.org/8817
committer: Lars Magne Ingebrigtsen <address@hidden>
branch nick: trunk
timestamp: Fri 2011-07-01 13:56:36 +0200
message:
  * dired.el (dired-mode): Fix up the doc string as suggested by
  Drew Adams (bug#8817).
modified:
  lisp/ChangeLog
  lisp/dired.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-07-01 10:33:50 +0000
+++ b/lisp/ChangeLog    2011-07-01 11:56:36 +0000
@@ -1,5 +1,8 @@
 2011-07-01  Lars Magne Ingebrigtsen  <address@hidden>
 
+       * dired.el (dired-mode): Fix up the doc string as suggested by
+       Drew Adams (bug#8817).
+
        * progmodes/flymake.el (flymake-find-file-hook): Add an `autoload'
        cookie, since the manual says that it should be possible to add
        this function to `find-file-hook' (bug#8709).

=== modified file 'lisp/dired.el'
--- a/lisp/dired.el     2011-06-19 18:39:24 +0000
+++ b/lisp/dired.el     2011-07-01 11:56:36 +0000
@@ -696,7 +696,6 @@
 its first element is taken as the directory name and the rest as an explicit
 list of files to make directory entries for.
 \\<dired-mode-map>\
-You can move around in it with the usual commands.
 You can flag files for deletion with \\[dired-flag-file-deletion] and then
 delete them by typing \\[dired-do-flagged-delete].
 Type \\[describe-mode] after entering Dired for more info.
@@ -1789,8 +1788,8 @@
   files for later commands or \"flag\" them for deletion, either file
   by file or all files matching certain criteria.
 You can move using the usual cursor motion commands.\\<dired-mode-map>
-Letters no longer insert themselves.  Digits are prefix arguments.
-Instead, type \\[dired-flag-file-deletion] to flag a file for Deletion.
+The buffer is read-only.  Digits are prefix arguments.
+Type \\[dired-flag-file-deletion] to flag a file `D' for deletion.
 Type \\[dired-mark] to Mark a file or subdirectory for later commands.
   Most commands operate on the marked files and use the current file
   if no files are marked.  Use a numeric prefix argument to operate on
@@ -1798,9 +1797,9 @@
   to operate on the current file only.  Prefix arguments override marks.
   Mark-using commands display a list of failures afterwards.  Type 
\\[dired-summary]
   to see why something went wrong.
-Type \\[dired-unmark] to Unmark a file or all files of a subdirectory.
+Type \\[dired-unmark] to Unmark a file or all files of an inserted 
subdirectory.
 Type \\[dired-unmark-backward] to back up one line and unflag.
-Type \\[dired-do-flagged-delete] to eXecute the deletions requested.
+Type \\[dired-do-flagged-delete] to delete (eXecute) the files flagged `D'.
 Type \\[dired-find-file] to Find the current line's file
   (or dired it in another buffer, if it is a directory).
 Type \\[dired-find-file-other-window] to find file or dired directory in Other 
window.
@@ -1810,12 +1809,12 @@
 Type \\[dired-sort-toggle-or-edit] to toggle Sorting by name/date or change 
the `ls' switches.
 Type \\[revert-buffer] to read all currently expanded directories aGain.
   This retains all marks and hides subdirs again that were hidden before.
-SPC and DEL can be used to move down and up by lines.
+Use `SPC' and `DEL' to move down and up by lines.
 
 If Dired ever gets confused, you can either type \\[revert-buffer] \
 to read the
 directories again, type \\[dired-do-redisplay] \
-to relist a single or the marked files or a
+to relist the file at point or the marked files or a
 subdirectory, or type \\[dired-build-subdir-alist] to parse the buffer
 again for the directory tree.