Commit 4691d21e authored by Eli Zaretskii's avatar Eli Zaretskii
Browse files

(Marks vs Flags): Explain that dired-undo doesn't undo the file

operations.
(Transforming File Names): Document that these commands operate on ARG or
marked files, and that they ask for confirmation on each file.
parent 50df7214
...@@ -437,7 +437,12 @@ name. ...@@ -437,7 +437,12 @@ name.
@kindex C-_ @r{(Dired)} @kindex C-_ @r{(Dired)}
@findex dired-undo @findex dired-undo
Undo changes in the Dired buffer, such as adding or removing Undo changes in the Dired buffer, such as adding or removing
marks (@code{dired-undo}). marks (@code{dired-undo}). @emph{This command does not revert the
actual file operations, nor recovers lost files!} It just undoes
changes in the buffer itself. For example, if used after renaming one
or more files, @code{dired-undo} restores the original names, which
will get the Dired buffer out of sync with the actual contents of the
directory.
@end table @end table
@node Operating on Files @node Operating on Files
...@@ -684,7 +689,21 @@ Updating}). ...@@ -684,7 +689,21 @@ Updating}).
@node Transforming File Names @node Transforming File Names
@section Transforming File Names in Dired @section Transforming File Names in Dired
Here are commands that alter file names in a systematic way: This section describes Dired commands which alter file names in a
systematic way.
Like the basic Dired file-manipulation commands (@pxref{Operating on
Files}), the commands described here operate either on the next
@var{n} files, or on all files marked with @samp{*}, or on the current
file. (To mark files, use the commands described in @ref{Marks vs
Flags}.)
All of the commands described in this section work
@emph{interactively}: they ask you to confirm the operation for each
candidate file. Thus, you can select more files than you actually
need to operate on (e.g., with a regexp that matches many files), and
then refine the selection by typing @kbd{y} or @kbd{n} when the
command prompts for confirmation.
@table @kbd @table @kbd
@findex dired-upcase @findex dired-upcase
...@@ -742,7 +761,8 @@ matches that should span the whole filename.) ...@@ -742,7 +761,8 @@ matches that should span the whole filename.)
Normally, the replacement process does not consider the files' Normally, the replacement process does not consider the files'
directory names; it operates on the file name within the directory. If directory names; it operates on the file name within the directory. If
you specify a numeric argument of zero, then replacement affects the you specify a numeric argument of zero, then replacement affects the
entire absolute file name including directory name. entire absolute file name including directory name. (Non-zero
argument specifies the number of files to operate on.)
Often you will want to select the set of files to operate on using the Often you will want to select the set of files to operate on using the
same @var{regexp} that you will use to operate on them. To do this, same @var{regexp} that you will use to operate on them. To do this,
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment