diff man/dired.texi @ 37484:0e8d5a17a47f

Fix command names dired-do-flagged-delete, dired-do-query-replace-regexp, dired-unmark-all-marks. Fix xrefs to Dired-X and Misc File Ops. Correct the uuencode shell command example to handle spaces. Explain prefix args to k and l better, especially negative args.

--- a/man/dired.texi	Thu Apr 26 00:26:05 2001 +0000
+++ b/man/dired.texi	Thu Apr 26 00:29:21 2001 +0000
@@ -13,7 +13,7 @@
 to operate on the files listed.
 
   The Dired-X package provides various extra features for Dired mode.
-@xref{,Dired-X,,dired-x, Dired Extra Version 2 User's Manual}.
+@xref{Dired-X,,,dired-x, Dired Extra Version 2 User's Manual}.
 
 @menu
 * Enter: Dired Enter.         How to invoke Dired.
@@ -121,16 +121,17 @@
 @kindex DEL @r{(Dired)}
   The files are flagged for deletion rather than deleted immediately to
 reduce the danger of deleting a file accidentally.  Until you direct
-Dired to expunge the flagged files, you can remove deletion flags using
+Dired to delete the flagged files, you can remove deletion flags using
 the commands @kbd{u} and @key{DEL}.  @kbd{u} (@code{dired-unmark}) works
 just like @kbd{d}, but removes flags rather than making flags.
 @key{DEL} (@code{dired-unmark-backward}) moves upward, removing flags;
 it is like @kbd{u} with argument @minus{}1.
 
 @kindex x @r{(Dired)}
-@findex dired-expunge
+@findex dired-do-flagged-delete
 @cindex expunging (Dired)
-  To delete the flagged files, type @kbd{x} (@code{dired-expunge}).
+  To delete the flagged files, type @kbd{x} (@code{dired-do-flagged-delete}).
+(This is also known as @dfn{expunging}.)
 This command first displays a list of all the file names flagged for
 deletion, and requests confirmation with @kbd{yes}.  If you confirm,
 Dired deletes the flagged files, then deletes their lines from the text
@@ -180,8 +181,8 @@
   @kbd{&} (@code{dired-flag-garbage-files}) flags files whose names
 match the regular expression specified by the variable
 @code{dired-garbage-files-regexp}.  By default, this matches certain
-files produced by @TeX{}, and the @samp{.orig} and @samp{.rej} files
-produced by @code{patch}.
+files produced by @TeX{}, @samp{.bak} files, and the @samp{.orig} and
+@samp{.rej} files produced by @code{patch}.
 
 @kindex # @r{(Dired)}
 @kindex ~ @r{(Dired)}
@@ -273,17 +274,17 @@
 
 Viewing a file is like visiting it, but is slanted toward moving around
 in the file conveniently and does not allow changing the file.
-@xref{Misc File Ops,View File}.
+@xref{Misc File Ops,View File, Miscellaneous File Operations}.
 @end table
 
 @node Marks vs Flags
 @section Dired Marks vs. Flags
 
 @cindex marking many files (in Dired)
-  Instead of flagging a file with @samp{D}, you can @dfn{mark} the file
-with some other character (usually @samp{*}).  Most Dired commands to
-operate on files, aside from ``expunge'' (@kbd{x}), look for files
-marked with @samp{*}.
+  Instead of flagging a file with @samp{D}, you can @dfn{mark} the
+file with some other character (usually @samp{*}).  Most Dired
+commands to operate on files use the files marked with @samp{*}, the
+exception being @kbd{x} which deletes the flagged files.
 
   Here are some commands for marking with @samp{*}, or for unmarking or
 operating on marks.  (@xref{Dired Deletion}, for commands to flag and
@@ -346,9 +347,9 @@
 
 @item * !
 @kindex * ! @r{(Dired)}
-@findex dired-unmark-all-files-no-query
+@findex dired-unmark-all-marks
 Remove all marks from all the files in this Dired buffer
-(@code{dired-unmark-all-files-no-query}).
+(@code{dired-unmark-all-marks}).
 
 @item * ? @var{markchar}
 @kindex * ? @r{(Dired)}
@@ -493,7 +494,7 @@
 Delete the specified files (@code{dired-do-delete}).  Like the other
 commands in this section, this command operates on the @emph{marked}
 files, or the next @var{n} files.  By contrast, @kbd{x}
-(@code{dired-expunge}) deletes all @dfn{flagged} files.
+(@code{dired-do-flagged-delete}) deletes all @dfn{flagged} files.
 
 @findex dired-do-rename
 @kindex R @r{(Dired)}
@@ -594,12 +595,12 @@
 the next match.  @xref{Tags Search}.
 
 @kindex Q @r{(Dired)}
-@findex dired-do-query-replace
+@findex dired-do-query-replace-regexp
 @cindex search and replace in multiple files (in Dired)
-@item Q @var{from} @key{RET} @var{to} @key{RET}
+@item Q @var{regexp} @key{RET} @var{to} @key{RET}
 Perform @code{query-replace-regexp} on each of the specified files,
-replacing matches for @var{from} (a regular expression) with the string
-@var{to} (@code{dired-do-query-replace}).
+replacing matches for @var{regexp} with the string
+@var{to} (@code{dired-do-query-replace-regexp}).
 
 This command is a variant of @code{tags-query-replace}.  If you exit the
 query replace loop, you can use @kbd{M-,} to resume the scan and replace
@@ -659,7 +660,7 @@
 uuencode each file:
 
 @example
-for file in *; do uuencode $file $file >$file.uu; done
+for file in *; do uuencode "$file" "$file" >"$file".uu; done
 @end example
 
 The working directory for the shell command is the top-level directory
@@ -817,7 +818,8 @@
 @section Moving Over Subdirectories
 
   When a Dired buffer lists subdirectories, you can use the page motion
-commands @kbd{C-x [} and @kbd{C-x ]} to move by entire directories.
+commands @kbd{C-x [} and @kbd{C-x ]} to move by entire directories
+(@pxref{Pages}).
 
 @cindex header line (Dired)
 @cindex directory header lines
@@ -936,20 +938,22 @@
 @kindex l @r{(Dired)}
 @findex dired-do-redisplay
   To update only some of the files, type @kbd{l}
-(@code{dired-do-redisplay}).  This command applies to the next @var{n}
-files, or to the marked files if any, or to the current file.  Updating
-them means reading their current status from the file system and
-changing the buffer to reflect it properly.
+(@code{dired-do-redisplay}).  Like the Dired file-operating commands,
+this command operates on the next @var{n} files (or previous
+@minus{}@var{n} files), or on the marked files if any, or on the
+current file.  Updating the files means reading their current status,
+then updating their lines in the buffer to indicate that status.
 
   If you use @kbd{l} on a subdirectory header line, it updates the
 contents of the corresponding subdirectory.
 
 @kindex k @r{(Dired)}
 @findex dired-do-kill-lines
-  To delete the specified @emph{file lines}---not the files, just the
-lines---type @kbd{k} (@code{dired-do-kill-lines}).  With a numeric
-argument @var{n}, this command applies to the next @var{n} files;
-otherwise, it applies to the marked files.
+  To delete the specified @emph{file lines} from the buffer---not
+delete 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.
 
   If you kill the line for a file that is a directory, the directory's
 contents are also deleted from the buffer.  Typing @kbd{C-u k} on the
@@ -958,7 +962,7 @@
 
   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
-reinsert each subdirectory.
+reinsert a subdirectory.
 
 @cindex Dired sorting
 @cindex sorting Dired buffer