annotate man/dired.texi @ 35749:c23c5efa3a48

*** empty log message ***
author Kenichi Handa <handa@m17n.org>
date Wed, 31 Jan 2001 00:11:38 +0000
parents c9c43bb7f1d2
children a1ff91eda21c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
28126
e7cf77f27506 Fix copyright line.
Dave Love <fx@gnu.org>
parents: 28041
diff changeset
2 @c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000
e7cf77f27506 Fix copyright line.
Dave Love <fx@gnu.org>
parents: 28041
diff changeset
3 @c Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @node Dired, Calendar/Diary, Rmail, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @chapter Dired, the Directory Editor
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @cindex Dired
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
8 @cindex file management
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
9
Dave Love <fx@gnu.org>
parents:
diff changeset
10 Dired makes an Emacs buffer containing a listing of a directory, and
Dave Love <fx@gnu.org>
parents:
diff changeset
11 optionally some of its subdirectories as well. You can use the normal
Dave Love <fx@gnu.org>
parents:
diff changeset
12 Emacs commands to move around in this buffer, and special Dired commands
Dave Love <fx@gnu.org>
parents:
diff changeset
13 to operate on the files listed.
Dave Love <fx@gnu.org>
parents:
diff changeset
14
Dave Love <fx@gnu.org>
parents:
diff changeset
15 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
16 * Enter: Dired Enter. How to invoke Dired.
Dave Love <fx@gnu.org>
parents:
diff changeset
17 * Commands: Dired Commands. Commands in the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
18 * Deletion: Dired Deletion. Deleting files with Dired.
Dave Love <fx@gnu.org>
parents:
diff changeset
19 * Flagging Many Files:: Flagging files based on their names.
Dave Love <fx@gnu.org>
parents:
diff changeset
20 * Visit: Dired Visiting. Other file operations through Dired.
Dave Love <fx@gnu.org>
parents:
diff changeset
21 * Marks vs Flags:: Flagging for deletion vs marking.
Dave Love <fx@gnu.org>
parents:
diff changeset
22 * Operating on Files:: How to copy, rename, print, compress, etc.
Dave Love <fx@gnu.org>
parents:
diff changeset
23 either one file or several files.
Dave Love <fx@gnu.org>
parents:
diff changeset
24 * Shell Commands in Dired:: Running a shell command on the marked files.
Dave Love <fx@gnu.org>
parents:
diff changeset
25 * Transforming File Names:: Using patterns to rename multiple files.
Dave Love <fx@gnu.org>
parents:
diff changeset
26 * Comparison in Dired:: Running `diff' by way of Dired.
Dave Love <fx@gnu.org>
parents:
diff changeset
27 * Subdirectories in Dired:: Adding subdirectories to the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
28 * Subdirectory Motion:: Moving across subdirectories, and up and down.
Dave Love <fx@gnu.org>
parents:
diff changeset
29 * Hiding Subdirectories:: Making subdirectories visible or invisible.
Dave Love <fx@gnu.org>
parents:
diff changeset
30 * Updating: Dired Updating. Discarding lines for files of no interest.
Dave Love <fx@gnu.org>
parents:
diff changeset
31 * Find: Dired and Find. Using `find' to choose the files for Dired.
30874
79e9f560240d dired-x tweaks
Dave Love <fx@gnu.org>
parents: 30114
diff changeset
32 * Extra: Dired Extra Features. Dired-X provides more features.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
33 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
34
Dave Love <fx@gnu.org>
parents:
diff changeset
35 @node Dired Enter
Dave Love <fx@gnu.org>
parents:
diff changeset
36 @section Entering Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
37
Dave Love <fx@gnu.org>
parents:
diff changeset
38 @findex dired
Dave Love <fx@gnu.org>
parents:
diff changeset
39 @kindex C-x d
Dave Love <fx@gnu.org>
parents:
diff changeset
40 @vindex dired-listing-switches
Dave Love <fx@gnu.org>
parents:
diff changeset
41 To invoke Dired, do @kbd{C-x d} or @kbd{M-x dired}. The command reads
Dave Love <fx@gnu.org>
parents:
diff changeset
42 a directory name or wildcard file name pattern as a minibuffer argument
Dave Love <fx@gnu.org>
parents:
diff changeset
43 to specify which files to list. Where @code{dired} differs from
Dave Love <fx@gnu.org>
parents:
diff changeset
44 @code{list-directory} is in putting the buffer into Dired mode so that
Dave Love <fx@gnu.org>
parents:
diff changeset
45 the special commands of Dired are available.
Dave Love <fx@gnu.org>
parents:
diff changeset
46
Dave Love <fx@gnu.org>
parents:
diff changeset
47 The variable @code{dired-listing-switches} specifies the options to
Dave Love <fx@gnu.org>
parents:
diff changeset
48 give to @code{ls} for listing directory; this string @emph{must} contain
Dave Love <fx@gnu.org>
parents:
diff changeset
49 @samp{-l}. If you use a numeric prefix argument with the @code{dired}
Dave Love <fx@gnu.org>
parents:
diff changeset
50 command, you can specify the @code{ls} switches with the minibuffer
Dave Love <fx@gnu.org>
parents:
diff changeset
51 before you enter the directory specification.
Dave Love <fx@gnu.org>
parents:
diff changeset
52
Dave Love <fx@gnu.org>
parents:
diff changeset
53 @findex dired-other-window
Dave Love <fx@gnu.org>
parents:
diff changeset
54 @kindex C-x 4 d
Dave Love <fx@gnu.org>
parents:
diff changeset
55 @findex dired-other-frame
Dave Love <fx@gnu.org>
parents:
diff changeset
56 @kindex C-x 5 d
Dave Love <fx@gnu.org>
parents:
diff changeset
57 To display the Dired buffer in another window rather than in the
Dave Love <fx@gnu.org>
parents:
diff changeset
58 selected window, use @kbd{C-x 4 d} (@code{dired-other-window}) instead
Dave Love <fx@gnu.org>
parents:
diff changeset
59 of @kbd{C-x d}. @kbd{C-x 5 d} (@code{dired-other-frame}) uses a
Dave Love <fx@gnu.org>
parents:
diff changeset
60 separate frame to display the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
61
Dave Love <fx@gnu.org>
parents:
diff changeset
62 @node Dired Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
63 @section Commands in the Dired Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
64
Dave Love <fx@gnu.org>
parents:
diff changeset
65 The Dired buffer is ``read-only,'' and inserting text in it is not
Dave Love <fx@gnu.org>
parents:
diff changeset
66 useful, so ordinary printing characters such as @kbd{d} and @kbd{x} are
Dave Love <fx@gnu.org>
parents:
diff changeset
67 used for special Dired commands. Some Dired commands @dfn{mark} or
Dave Love <fx@gnu.org>
parents:
diff changeset
68 @dfn{flag} the @dfn{current file} (that is, the file on the current
Dave Love <fx@gnu.org>
parents:
diff changeset
69 line); other commands operate on the marked files or on the flagged
Dave Love <fx@gnu.org>
parents:
diff changeset
70 files.
Dave Love <fx@gnu.org>
parents:
diff changeset
71
Dave Love <fx@gnu.org>
parents:
diff changeset
72 @kindex C-n @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
73 @kindex C-p @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
74 All the usual Emacs cursor motion commands are available in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
75 buffers. Some special-purpose cursor motion commands are also
Dave Love <fx@gnu.org>
parents:
diff changeset
76 provided. The keys @kbd{C-n} and @kbd{C-p} are redefined to put the
Dave Love <fx@gnu.org>
parents:
diff changeset
77 cursor at the beginning of the file name on the line, rather than at the
Dave Love <fx@gnu.org>
parents:
diff changeset
78 beginning of the line.
Dave Love <fx@gnu.org>
parents:
diff changeset
79
Dave Love <fx@gnu.org>
parents:
diff changeset
80 @kindex SPC @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
81 For extra convenience, @key{SPC} and @kbd{n} in Dired are equivalent
Dave Love <fx@gnu.org>
parents:
diff changeset
82 to @kbd{C-n}. @kbd{p} is equivalent to @kbd{C-p}. (Moving by lines is
Dave Love <fx@gnu.org>
parents:
diff changeset
83 so common in Dired that it deserves to be easy to type.) @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
84 (move up and unflag) is often useful simply for moving up.
Dave Love <fx@gnu.org>
parents:
diff changeset
85
Dave Love <fx@gnu.org>
parents:
diff changeset
86 @node Dired Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
87 @section Deleting Files with Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
88 @cindex flagging files (in Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
89 @cindex deleting files (in Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
90
Dave Love <fx@gnu.org>
parents:
diff changeset
91 The primary use of Dired is to @dfn{flag} files for deletion and then
Dave Love <fx@gnu.org>
parents:
diff changeset
92 delete the files previously flagged.
Dave Love <fx@gnu.org>
parents:
diff changeset
93
Dave Love <fx@gnu.org>
parents:
diff changeset
94 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
95 @item d
Dave Love <fx@gnu.org>
parents:
diff changeset
96 Flag this file for deletion.
Dave Love <fx@gnu.org>
parents:
diff changeset
97 @item u
Dave Love <fx@gnu.org>
parents:
diff changeset
98 Remove deletion flag on this line.
Dave Love <fx@gnu.org>
parents:
diff changeset
99 @item @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
100 Move point to previous line and remove the deletion flag on that line.
Dave Love <fx@gnu.org>
parents:
diff changeset
101 @item x
Dave Love <fx@gnu.org>
parents:
diff changeset
102 Delete the files that are flagged for deletion.
Dave Love <fx@gnu.org>
parents:
diff changeset
103 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
104
Dave Love <fx@gnu.org>
parents:
diff changeset
105 @kindex d @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
106 @findex dired-flag-file-deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
107 You can flag a file for deletion by moving to the line describing the
Dave Love <fx@gnu.org>
parents:
diff changeset
108 file and typing @kbd{d} (@code{dired-flag-file-deletion}). The deletion flag is visible as a @samp{D} at
Dave Love <fx@gnu.org>
parents:
diff changeset
109 the beginning of the line. This command moves point to the next line,
Dave Love <fx@gnu.org>
parents:
diff changeset
110 so that repeated @kbd{d} commands flag successive files. A numeric
Dave Love <fx@gnu.org>
parents:
diff changeset
111 argument serves as a repeat count.
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
112 @vindex dired-recursive-deletes
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
113 The variable @code{dired-recursive-deletes} determines if the delete
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
114 command will delete non-empty directories recursively. The default
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
115 is to delete only empty directories.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
116
Dave Love <fx@gnu.org>
parents:
diff changeset
117 @kindex u @r{(Dired deletion)}
Dave Love <fx@gnu.org>
parents:
diff changeset
118 @kindex DEL @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
119 The files are flagged for deletion rather than deleted immediately to
Dave Love <fx@gnu.org>
parents:
diff changeset
120 reduce the danger of deleting a file accidentally. Until you direct
Dave Love <fx@gnu.org>
parents:
diff changeset
121 Dired to expunge the flagged files, you can remove deletion flags using
Dave Love <fx@gnu.org>
parents:
diff changeset
122 the commands @kbd{u} and @key{DEL}. @kbd{u} (@code{dired-unmark}) works
Dave Love <fx@gnu.org>
parents:
diff changeset
123 just like @kbd{d}, but removes flags rather than making flags.
Dave Love <fx@gnu.org>
parents:
diff changeset
124 @key{DEL} (@code{dired-unmark-backward}) moves upward, removing flags;
Dave Love <fx@gnu.org>
parents:
diff changeset
125 it is like @kbd{u} with argument @minus{}1.
Dave Love <fx@gnu.org>
parents:
diff changeset
126
Dave Love <fx@gnu.org>
parents:
diff changeset
127 @kindex x @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
128 @findex dired-expunge
Dave Love <fx@gnu.org>
parents:
diff changeset
129 @cindex expunging (Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
130 To delete the flagged files, type @kbd{x} (@code{dired-expunge}).
Dave Love <fx@gnu.org>
parents:
diff changeset
131 This command first displays a list of all the file names flagged for
Dave Love <fx@gnu.org>
parents:
diff changeset
132 deletion, and requests confirmation with @kbd{yes}. If you confirm,
Dave Love <fx@gnu.org>
parents:
diff changeset
133 Dired deletes the flagged files, then deletes their lines from the text
Dave Love <fx@gnu.org>
parents:
diff changeset
134 of the Dired buffer. The shortened Dired buffer remains selected.
Dave Love <fx@gnu.org>
parents:
diff changeset
135
Dave Love <fx@gnu.org>
parents:
diff changeset
136 If you answer @kbd{no} or quit with @kbd{C-g} when asked to confirm, you
Dave Love <fx@gnu.org>
parents:
diff changeset
137 return immediately to Dired, with the deletion flags still present in
Dave Love <fx@gnu.org>
parents:
diff changeset
138 the buffer, and no files actually deleted.
Dave Love <fx@gnu.org>
parents:
diff changeset
139
Dave Love <fx@gnu.org>
parents:
diff changeset
140 @node Flagging Many Files
Dave Love <fx@gnu.org>
parents:
diff changeset
141 @section Flagging Many Files at Once
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
142 @cindex flagging many files for deletion (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
143
Dave Love <fx@gnu.org>
parents:
diff changeset
144 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
145 @item #
Dave Love <fx@gnu.org>
parents:
diff changeset
146 Flag all auto-save files (files whose names start and end with @samp{#})
Dave Love <fx@gnu.org>
parents:
diff changeset
147 for deletion (@pxref{Auto Save}).
Dave Love <fx@gnu.org>
parents:
diff changeset
148
Dave Love <fx@gnu.org>
parents:
diff changeset
149 @item ~
Dave Love <fx@gnu.org>
parents:
diff changeset
150 Flag all backup files (files whose names end with @samp{~}) for deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
151 (@pxref{Backup}).
Dave Love <fx@gnu.org>
parents:
diff changeset
152
Dave Love <fx@gnu.org>
parents:
diff changeset
153 @item &
Dave Love <fx@gnu.org>
parents:
diff changeset
154 Flag for deletion all files with certain kinds of names, names that
Dave Love <fx@gnu.org>
parents:
diff changeset
155 suggest you could easily create the files again.
Dave Love <fx@gnu.org>
parents:
diff changeset
156
Dave Love <fx@gnu.org>
parents:
diff changeset
157 @item .@: @r{(Period)}
Dave Love <fx@gnu.org>
parents:
diff changeset
158 Flag excess numeric backup files for deletion. The oldest and newest
Dave Love <fx@gnu.org>
parents:
diff changeset
159 few backup files of any one file are exempt; the middle ones are
Dave Love <fx@gnu.org>
parents:
diff changeset
160 flagged.
Dave Love <fx@gnu.org>
parents:
diff changeset
161
Dave Love <fx@gnu.org>
parents:
diff changeset
162 @item % d @var{regexp} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
163 Flag for deletion all files whose names match the regular expression
Dave Love <fx@gnu.org>
parents:
diff changeset
164 @var{regexp}.
Dave Love <fx@gnu.org>
parents:
diff changeset
165 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
166
Dave Love <fx@gnu.org>
parents:
diff changeset
167 The @kbd{#}, @kbd{~}, @kbd{&}, and @kbd{.} commands flag many files for
Dave Love <fx@gnu.org>
parents:
diff changeset
168 deletion, based on their file names. These commands are useful
Dave Love <fx@gnu.org>
parents:
diff changeset
169 precisely because they do not themselves delete any files; you can
Dave Love <fx@gnu.org>
parents:
diff changeset
170 remove the deletion flags from any flagged files that you really wish to
Dave Love <fx@gnu.org>
parents:
diff changeset
171 keep.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
172
Dave Love <fx@gnu.org>
parents:
diff changeset
173 @kindex & @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
174 @findex dired-flag-garbage-files
Dave Love <fx@gnu.org>
parents:
diff changeset
175 @vindex dired-garbage-files-regexp
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
176 @cindex deleting some backup files
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
177 @kbd{&} (@code{dired-flag-garbage-files}) flags files whose names
Dave Love <fx@gnu.org>
parents:
diff changeset
178 match the regular expression specified by the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
179 @code{dired-garbage-files-regexp}. By default, this matches certain
Dave Love <fx@gnu.org>
parents:
diff changeset
180 files produced by @TeX{}, and the @samp{.orig} and @samp{.rej} files
Dave Love <fx@gnu.org>
parents:
diff changeset
181 produced by @code{patch}.
Dave Love <fx@gnu.org>
parents:
diff changeset
182
Dave Love <fx@gnu.org>
parents:
diff changeset
183 @kindex # @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
184 @kindex ~ @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
185 @findex dired-flag-auto-save-files
Dave Love <fx@gnu.org>
parents:
diff changeset
186 @findex dired-flag-backup-files
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
187 @cindex deleting auto-save files
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
188 @kbd{#} (@code{dired-flag-auto-save-files}) flags for deletion all
Dave Love <fx@gnu.org>
parents:
diff changeset
189 files whose names look like auto-save files (@pxref{Auto Save})---that
Dave Love <fx@gnu.org>
parents:
diff changeset
190 is, files whose names begin and end with @samp{#}. @kbd{~}
Dave Love <fx@gnu.org>
parents:
diff changeset
191 (@code{dired-flag-backup-files}) flags for deletion all files whose
Dave Love <fx@gnu.org>
parents:
diff changeset
192 names say they are backup files (@pxref{Backup})---that is, whose names
Dave Love <fx@gnu.org>
parents:
diff changeset
193 end in @samp{~}.
Dave Love <fx@gnu.org>
parents:
diff changeset
194
Dave Love <fx@gnu.org>
parents:
diff changeset
195 @kindex . @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
196 @vindex dired-kept-versions
Dave Love <fx@gnu.org>
parents:
diff changeset
197 @findex dired-clean-directory
Dave Love <fx@gnu.org>
parents:
diff changeset
198 @kbd{.} (period, @code{dired-clean-directory}) flags just some of the
Dave Love <fx@gnu.org>
parents:
diff changeset
199 backup files for deletion: all but the oldest few and newest few backups
Dave Love <fx@gnu.org>
parents:
diff changeset
200 of any one file. Normally @code{dired-kept-versions} (@strong{not}
Dave Love <fx@gnu.org>
parents:
diff changeset
201 @code{kept-new-versions}; that applies only when saving) specifies the
Dave Love <fx@gnu.org>
parents:
diff changeset
202 number of newest versions of each file to keep, and
Dave Love <fx@gnu.org>
parents:
diff changeset
203 @code{kept-old-versions} specifies the number of oldest versions to
Dave Love <fx@gnu.org>
parents:
diff changeset
204 keep.
Dave Love <fx@gnu.org>
parents:
diff changeset
205
Dave Love <fx@gnu.org>
parents:
diff changeset
206 Period with a positive numeric argument, as in @kbd{C-u 3 .},
Dave Love <fx@gnu.org>
parents:
diff changeset
207 specifies the number of newest versions to keep, overriding
Dave Love <fx@gnu.org>
parents:
diff changeset
208 @code{dired-kept-versions}. A negative numeric argument overrides
Dave Love <fx@gnu.org>
parents:
diff changeset
209 @code{kept-old-versions}, using minus the value of the argument to
Dave Love <fx@gnu.org>
parents:
diff changeset
210 specify the number of oldest versions of each file to keep.
Dave Love <fx@gnu.org>
parents:
diff changeset
211
Dave Love <fx@gnu.org>
parents:
diff changeset
212 @findex dired-flag-files-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
213 @kindex % d @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
214 The @kbd{% d} command flags all files whose names match a specified
Dave Love <fx@gnu.org>
parents:
diff changeset
215 regular expression (@code{dired-flag-files-regexp}). Only the
Dave Love <fx@gnu.org>
parents:
diff changeset
216 non-directory part of the file name is used in matching. You can use
Dave Love <fx@gnu.org>
parents:
diff changeset
217 @samp{^} and @samp{$} to anchor matches. You can exclude subdirectories
Dave Love <fx@gnu.org>
parents:
diff changeset
218 by hiding them (@pxref{Hiding Subdirectories}).
Dave Love <fx@gnu.org>
parents:
diff changeset
219
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @node Dired Visiting
Dave Love <fx@gnu.org>
parents:
diff changeset
221 @section Visiting Files in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
222
Dave Love <fx@gnu.org>
parents:
diff changeset
223 There are several Dired commands for visiting or examining the files
Dave Love <fx@gnu.org>
parents:
diff changeset
224 listed in the Dired buffer. All of them apply to the current line's
Dave Love <fx@gnu.org>
parents:
diff changeset
225 file; if that file is really a directory, these commands invoke Dired on
Dave Love <fx@gnu.org>
parents:
diff changeset
226 that subdirectory (making a separate Dired buffer).
Dave Love <fx@gnu.org>
parents:
diff changeset
227
Dave Love <fx@gnu.org>
parents:
diff changeset
228 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
229 @item f
Dave Love <fx@gnu.org>
parents:
diff changeset
230 @kindex f @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
231 @findex dired-find-file
Dave Love <fx@gnu.org>
parents:
diff changeset
232 Visit the file described on the current line, like typing @kbd{C-x C-f}
Dave Love <fx@gnu.org>
parents:
diff changeset
233 and supplying that file name (@code{dired-find-file}). @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
234
Dave Love <fx@gnu.org>
parents:
diff changeset
235 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
236 @kindex RET @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
237 Equivalent to @kbd{f}.
Dave Love <fx@gnu.org>
parents:
diff changeset
238
30114
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
239 @item a
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
240 @kindex a @r{(Dired)}
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
241 @findex dired-find-alternate-file
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
242 Like @kbd{f}, but replaces the contents of the Dired buffer with
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
243 that of an alternate file or directory.
50c69ce6e1b0 Describe dired-find-alternate-file.
Gerd Moellmann <gerd@gnu.org>
parents: 28126
diff changeset
244
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
245 @item o
Dave Love <fx@gnu.org>
parents:
diff changeset
246 @kindex o @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
247 @findex dired-find-file-other-window
Dave Love <fx@gnu.org>
parents:
diff changeset
248 Like @kbd{f}, but uses another window to display the file's buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
249 (@code{dired-find-file-other-window}). The Dired buffer remains visible
Dave Love <fx@gnu.org>
parents:
diff changeset
250 in the first window. This is like using @kbd{C-x 4 C-f} to visit the
Dave Love <fx@gnu.org>
parents:
diff changeset
251 file. @xref{Windows}.
Dave Love <fx@gnu.org>
parents:
diff changeset
252
Dave Love <fx@gnu.org>
parents:
diff changeset
253 @item C-o
Dave Love <fx@gnu.org>
parents:
diff changeset
254 @kindex C-o @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
255 @findex dired-display-file
Dave Love <fx@gnu.org>
parents:
diff changeset
256 Visit the file described on the current line, and display the buffer in
Dave Love <fx@gnu.org>
parents:
diff changeset
257 another window, but do not select that window (@code{dired-display-file}).
Dave Love <fx@gnu.org>
parents:
diff changeset
258
Dave Love <fx@gnu.org>
parents:
diff changeset
259 @item Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
260 @findex dired-mouse-find-file-other-window
Dave Love <fx@gnu.org>
parents:
diff changeset
261 Visit the file named by the line you click on
Dave Love <fx@gnu.org>
parents:
diff changeset
262 (@code{dired-mouse-find-file-other-window}). This uses another window
Dave Love <fx@gnu.org>
parents:
diff changeset
263 to display the file, like the @kbd{o} command.
Dave Love <fx@gnu.org>
parents:
diff changeset
264
Dave Love <fx@gnu.org>
parents:
diff changeset
265 @item v
Dave Love <fx@gnu.org>
parents:
diff changeset
266 @kindex v @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
267 @findex dired-view-file
Dave Love <fx@gnu.org>
parents:
diff changeset
268 View the file described on the current line, using @kbd{M-x view-file}
Dave Love <fx@gnu.org>
parents:
diff changeset
269 (@code{dired-view-file}).
Dave Love <fx@gnu.org>
parents:
diff changeset
270
Dave Love <fx@gnu.org>
parents:
diff changeset
271 Viewing a file is like visiting it, but is slanted toward moving around
Dave Love <fx@gnu.org>
parents:
diff changeset
272 in the file conveniently and does not allow changing the file.
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @xref{Misc File Ops,View File}.
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
275
Dave Love <fx@gnu.org>
parents:
diff changeset
276 @node Marks vs Flags
Dave Love <fx@gnu.org>
parents:
diff changeset
277 @section Dired Marks vs. Flags
Dave Love <fx@gnu.org>
parents:
diff changeset
278
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
279 @cindex marking many files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
280 Instead of flagging a file with @samp{D}, you can @dfn{mark} the file
Dave Love <fx@gnu.org>
parents:
diff changeset
281 with some other character (usually @samp{*}). Most Dired commands to
Dave Love <fx@gnu.org>
parents:
diff changeset
282 operate on files, aside from ``expunge'' (@kbd{x}), look for files
Dave Love <fx@gnu.org>
parents:
diff changeset
283 marked with @samp{*}.
Dave Love <fx@gnu.org>
parents:
diff changeset
284
Dave Love <fx@gnu.org>
parents:
diff changeset
285 Here are some commands for marking with @samp{*}, or for unmarking or
Dave Love <fx@gnu.org>
parents:
diff changeset
286 operating on marks. (@xref{Dired Deletion}, for commands to flag and
Dave Love <fx@gnu.org>
parents:
diff changeset
287 unflag files.)
Dave Love <fx@gnu.org>
parents:
diff changeset
288
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
290 @item m
Dave Love <fx@gnu.org>
parents:
diff changeset
291 @itemx * m
Dave Love <fx@gnu.org>
parents:
diff changeset
292 @kindex m @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
293 @kindex * m @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @findex dired-mark
Dave Love <fx@gnu.org>
parents:
diff changeset
295 Mark the current file with @samp{*} (@code{dired-mark}). With a numeric
Dave Love <fx@gnu.org>
parents:
diff changeset
296 argument @var{n}, mark the next @var{n} files starting with the current
Dave Love <fx@gnu.org>
parents:
diff changeset
297 file. (If @var{n} is negative, mark the previous @minus{}@var{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
298 files.)
Dave Love <fx@gnu.org>
parents:
diff changeset
299
Dave Love <fx@gnu.org>
parents:
diff changeset
300 @item * *
Dave Love <fx@gnu.org>
parents:
diff changeset
301 @kindex * * @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
302 @findex dired-mark-executables
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
303 @cindex marking executable files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
304 Mark all executable files with @samp{*}
Dave Love <fx@gnu.org>
parents:
diff changeset
305 (@code{dired-mark-executables}). With a numeric argument, unmark all
Dave Love <fx@gnu.org>
parents:
diff changeset
306 those files.
Dave Love <fx@gnu.org>
parents:
diff changeset
307
Dave Love <fx@gnu.org>
parents:
diff changeset
308 @item * @@
Dave Love <fx@gnu.org>
parents:
diff changeset
309 @kindex * @@ @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
310 @findex dired-mark-symlinks
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
311 @cindex marking symlinks (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
312 Mark all symbolic links with @samp{*} (@code{dired-mark-symlinks}).
Dave Love <fx@gnu.org>
parents:
diff changeset
313 With a numeric argument, unmark all those files.
Dave Love <fx@gnu.org>
parents:
diff changeset
314
Dave Love <fx@gnu.org>
parents:
diff changeset
315 @item * /
Dave Love <fx@gnu.org>
parents:
diff changeset
316 @kindex * / @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
317 @findex dired-mark-directories
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
318 @cindex marking subdirectories (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
319 Mark with @samp{*} all files which are actually directories, except for
Dave Love <fx@gnu.org>
parents:
diff changeset
320 @file{.} and @file{..} (@code{dired-mark-directories}). With a numeric
Dave Love <fx@gnu.org>
parents:
diff changeset
321 argument, unmark all those files.
Dave Love <fx@gnu.org>
parents:
diff changeset
322
Dave Love <fx@gnu.org>
parents:
diff changeset
323 @item * s
Dave Love <fx@gnu.org>
parents:
diff changeset
324 @kindex * s @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
325 @findex dired-mark-subdir-files
Dave Love <fx@gnu.org>
parents:
diff changeset
326 Mark all the files in the current subdirectory, aside from @file{.}
Dave Love <fx@gnu.org>
parents:
diff changeset
327 and @file{..} (@code{dired-mark-subdir-files}).
Dave Love <fx@gnu.org>
parents:
diff changeset
328
Dave Love <fx@gnu.org>
parents:
diff changeset
329 @item u
Dave Love <fx@gnu.org>
parents:
diff changeset
330 @itemx * u
Dave Love <fx@gnu.org>
parents:
diff changeset
331 @kindex u @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
332 @kindex * u @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
333 @findex dired-unmark
Dave Love <fx@gnu.org>
parents:
diff changeset
334 Remove any mark on this line (@code{dired-unmark}).
Dave Love <fx@gnu.org>
parents:
diff changeset
335
Dave Love <fx@gnu.org>
parents:
diff changeset
336 @item @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
337 @itemx * @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
338 @kindex * DEL @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
339 @findex dired-unmark-backward
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
340 @cindex unmarking files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
341 Move point to previous line and remove any mark on that line
Dave Love <fx@gnu.org>
parents:
diff changeset
342 (@code{dired-unmark-backward}).
Dave Love <fx@gnu.org>
parents:
diff changeset
343
Dave Love <fx@gnu.org>
parents:
diff changeset
344 @item * !
Dave Love <fx@gnu.org>
parents:
diff changeset
345 @kindex * ! @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
346 @findex dired-unmark-all-files-no-query
Dave Love <fx@gnu.org>
parents:
diff changeset
347 Remove all marks from all the files in this Dired buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
348 (@code{dired-unmark-all-files-no-query}).
Dave Love <fx@gnu.org>
parents:
diff changeset
349
Dave Love <fx@gnu.org>
parents:
diff changeset
350 @item * ? @var{markchar}
Dave Love <fx@gnu.org>
parents:
diff changeset
351 @kindex * ? @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
352 @findex dired-unmark-all-files
Dave Love <fx@gnu.org>
parents:
diff changeset
353 Remove all marks that use the character @var{markchar}
Dave Love <fx@gnu.org>
parents:
diff changeset
354 (@code{dired-unmark-all-files}). The argument is a single
Dave Love <fx@gnu.org>
parents:
diff changeset
355 character---do not use @key{RET} to terminate it.
Dave Love <fx@gnu.org>
parents:
diff changeset
356
Dave Love <fx@gnu.org>
parents:
diff changeset
357 With a numeric argument, this command queries about each marked file,
Dave Love <fx@gnu.org>
parents:
diff changeset
358 asking whether to remove its mark. You can answer @kbd{y} meaning yes,
Dave Love <fx@gnu.org>
parents:
diff changeset
359 @kbd{n} meaning no, or @kbd{!} to remove the marks from the remaining
Dave Love <fx@gnu.org>
parents:
diff changeset
360 files without asking about them.
Dave Love <fx@gnu.org>
parents:
diff changeset
361
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @item * C-n
Dave Love <fx@gnu.org>
parents:
diff changeset
363 @findex dired-next-marked-file
Dave Love <fx@gnu.org>
parents:
diff changeset
364 @kindex * C-n @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
365 Move down to the next marked file (@code{dired-next-marked-file})
Dave Love <fx@gnu.org>
parents:
diff changeset
366 A file is ``marked'' if it has any kind of mark.
Dave Love <fx@gnu.org>
parents:
diff changeset
367
Dave Love <fx@gnu.org>
parents:
diff changeset
368 @item * C-p
Dave Love <fx@gnu.org>
parents:
diff changeset
369 @findex dired-prev-marked-file
Dave Love <fx@gnu.org>
parents:
diff changeset
370 @kindex * C-p @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
371 Move up to the previous marked file (@code{dired-prev-marked-file})
Dave Love <fx@gnu.org>
parents:
diff changeset
372
Dave Love <fx@gnu.org>
parents:
diff changeset
373 @item * t
Dave Love <fx@gnu.org>
parents:
diff changeset
374 @kindex * t @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
375 @findex dired-do-toggle
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
376 @cindex toggling marks (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
377 Toggle all marks (@code{dired-do-toggle}): files marked with @samp{*}
Dave Love <fx@gnu.org>
parents:
diff changeset
378 become unmarked, and unmarked files are marked with @samp{*}. Files
Dave Love <fx@gnu.org>
parents:
diff changeset
379 marked in any other way are not affected.
Dave Love <fx@gnu.org>
parents:
diff changeset
380
Dave Love <fx@gnu.org>
parents:
diff changeset
381 @item * c @var{old} @var{new}
Dave Love <fx@gnu.org>
parents:
diff changeset
382 @kindex * c @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
383 @findex dired-change-marks
Dave Love <fx@gnu.org>
parents:
diff changeset
384 Replace all marks that use the character @var{old} with marks that use
Dave Love <fx@gnu.org>
parents:
diff changeset
385 the character @var{new} (@code{dired-change-marks}). This command is
Dave Love <fx@gnu.org>
parents:
diff changeset
386 the primary way to create or use marks other than @samp{*} or @samp{D}.
Dave Love <fx@gnu.org>
parents:
diff changeset
387 The arguments are single characters---do not use @key{RET} to terminate
Dave Love <fx@gnu.org>
parents:
diff changeset
388 them.
Dave Love <fx@gnu.org>
parents:
diff changeset
389
Dave Love <fx@gnu.org>
parents:
diff changeset
390 You can use almost any character as a mark character by means of this
Dave Love <fx@gnu.org>
parents:
diff changeset
391 command, to distinguish various classes of files. If @var{old} is a
Dave Love <fx@gnu.org>
parents:
diff changeset
392 space (@samp{ }), then the command operates on all unmarked files; if
Dave Love <fx@gnu.org>
parents:
diff changeset
393 @var{new} is a space, then the command unmarks the files it acts on.
Dave Love <fx@gnu.org>
parents:
diff changeset
394
Dave Love <fx@gnu.org>
parents:
diff changeset
395 To illustrate the power of this command, here is how to put @samp{D}
Dave Love <fx@gnu.org>
parents:
diff changeset
396 flags on all the files that have no marks, while unflagging all those
Dave Love <fx@gnu.org>
parents:
diff changeset
397 that already have @samp{D} flags:
Dave Love <fx@gnu.org>
parents:
diff changeset
398
Dave Love <fx@gnu.org>
parents:
diff changeset
399 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
400 * c D t * c SPC D * c t SPC
Dave Love <fx@gnu.org>
parents:
diff changeset
401 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
402
Dave Love <fx@gnu.org>
parents:
diff changeset
403 This assumes that no files are marked with @samp{t}.
Dave Love <fx@gnu.org>
parents:
diff changeset
404
Dave Love <fx@gnu.org>
parents:
diff changeset
405 @item % m @var{regexp} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
406 @itemx * % @var{regexp} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
407 @findex dired-mark-files-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
408 @kindex % m @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
409 @kindex * % @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
410 Mark (with @samp{*}) all files whose names match the regular expression
Dave Love <fx@gnu.org>
parents:
diff changeset
411 @var{regexp} (@code{dired-mark-files-regexp}). This command is like
Dave Love <fx@gnu.org>
parents:
diff changeset
412 @kbd{% d}, except that it marks files with @samp{*} instead of flagging
Dave Love <fx@gnu.org>
parents:
diff changeset
413 with @samp{D}. @xref{Flagging Many Files}.
Dave Love <fx@gnu.org>
parents:
diff changeset
414
Dave Love <fx@gnu.org>
parents:
diff changeset
415 Only the non-directory part of the file name is used in matching. Use
Dave Love <fx@gnu.org>
parents:
diff changeset
416 @samp{^} and @samp{$} to anchor matches. Exclude subdirectories by
Dave Love <fx@gnu.org>
parents:
diff changeset
417 hiding them (@pxref{Hiding Subdirectories}).
Dave Love <fx@gnu.org>
parents:
diff changeset
418
Dave Love <fx@gnu.org>
parents:
diff changeset
419 @item % g @var{regexp} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
420 @findex dired-mark-files-containing-regexp
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
421 @kindex % g @r{(Dired)}
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
422 @cindex finding files containing regexp matches (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
423 Mark (with @samp{*}) all files whose @emph{contents} contain a match for
Dave Love <fx@gnu.org>
parents:
diff changeset
424 the regular expression @var{regexp}
Dave Love <fx@gnu.org>
parents:
diff changeset
425 (@code{dired-mark-files-containing-regexp}). This command is like
Dave Love <fx@gnu.org>
parents:
diff changeset
426 @kbd{% m}, except that it searches the file contents instead of the file
Dave Love <fx@gnu.org>
parents:
diff changeset
427 name.
Dave Love <fx@gnu.org>
parents:
diff changeset
428
Dave Love <fx@gnu.org>
parents:
diff changeset
429 @item C-_
Dave Love <fx@gnu.org>
parents:
diff changeset
430 @kindex C-_ @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
431 @findex dired-undo
Dave Love <fx@gnu.org>
parents:
diff changeset
432 Undo changes in the Dired buffer, such as adding or removing
Dave Love <fx@gnu.org>
parents:
diff changeset
433 marks (@code{dired-undo}).
Dave Love <fx@gnu.org>
parents:
diff changeset
434 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
435
Dave Love <fx@gnu.org>
parents:
diff changeset
436 @node Operating on Files
Dave Love <fx@gnu.org>
parents:
diff changeset
437 @section Operating on Files
Dave Love <fx@gnu.org>
parents:
diff changeset
438 @cindex operating on files in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
439
Dave Love <fx@gnu.org>
parents:
diff changeset
440 This section describes the basic Dired commands to operate on one file
Dave Love <fx@gnu.org>
parents:
diff changeset
441 or several files. All of these commands are capital letters; all of
Dave Love <fx@gnu.org>
parents:
diff changeset
442 them use the minibuffer, either to read an argument or to ask for
Dave Love <fx@gnu.org>
parents:
diff changeset
443 confirmation, before they act. All of them give you several ways to
Dave Love <fx@gnu.org>
parents:
diff changeset
444 specify which files to manipulate:
Dave Love <fx@gnu.org>
parents:
diff changeset
445
Dave Love <fx@gnu.org>
parents:
diff changeset
446 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
447 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
448 If you give the command a numeric prefix argument @var{n}, it operates
Dave Love <fx@gnu.org>
parents:
diff changeset
449 on the next @var{n} files, starting with the current file. (If @var{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
450 is negative, the command operates on the @minus{}@var{n} files preceding
Dave Love <fx@gnu.org>
parents:
diff changeset
451 the current line.)
Dave Love <fx@gnu.org>
parents:
diff changeset
452
Dave Love <fx@gnu.org>
parents:
diff changeset
453 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
454 Otherwise, if some files are marked with @samp{*}, the command operates
Dave Love <fx@gnu.org>
parents:
diff changeset
455 on all those files.
Dave Love <fx@gnu.org>
parents:
diff changeset
456
Dave Love <fx@gnu.org>
parents:
diff changeset
457 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
458 Otherwise, the command operates on the current file only.
Dave Love <fx@gnu.org>
parents:
diff changeset
459 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
460
Dave Love <fx@gnu.org>
parents:
diff changeset
461 Here are the file-manipulating commands that operate on files in this
Dave Love <fx@gnu.org>
parents:
diff changeset
462 way. (Some other Dired commands, such as @kbd{!} and the @samp{%}
Dave Love <fx@gnu.org>
parents:
diff changeset
463 commands, also use these conventions to decide which files to work on.)
Dave Love <fx@gnu.org>
parents:
diff changeset
464
Dave Love <fx@gnu.org>
parents:
diff changeset
465 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
466 @findex dired-do-copy
Dave Love <fx@gnu.org>
parents:
diff changeset
467 @kindex C @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
468 @cindex copying files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
469 @item C @var{new} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
470 Copy the specified files (@code{dired-do-copy}). The argument @var{new}
Dave Love <fx@gnu.org>
parents:
diff changeset
471 is the directory to copy into, or (if copying a single file) the new
Dave Love <fx@gnu.org>
parents:
diff changeset
472 name.
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
473 @vindex dired-recursive-copies
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
474 The variable @code{dired-recursive-copies} determines if directories are
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
475 copied recursively. The default is to not copy recursively.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
476
Dave Love <fx@gnu.org>
parents:
diff changeset
477 @vindex dired-copy-preserve-time
Dave Love <fx@gnu.org>
parents:
diff changeset
478 If @code{dired-copy-preserve-time} is non-@code{nil}, then copying with
Dave Love <fx@gnu.org>
parents:
diff changeset
479 this command sets the modification time of the new file to be the same
Dave Love <fx@gnu.org>
parents:
diff changeset
480 as that of the old file.
Dave Love <fx@gnu.org>
parents:
diff changeset
481
Dave Love <fx@gnu.org>
parents:
diff changeset
482 @item D
Dave Love <fx@gnu.org>
parents:
diff changeset
483 @findex dired-do-delete
Dave Love <fx@gnu.org>
parents:
diff changeset
484 @kindex D @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
485 Delete the specified files (@code{dired-do-delete}). Like the other
Dave Love <fx@gnu.org>
parents:
diff changeset
486 commands in this section, this command operates on the @emph{marked}
Dave Love <fx@gnu.org>
parents:
diff changeset
487 files, or the next @var{n} files. By contrast, @kbd{x}
Dave Love <fx@gnu.org>
parents:
diff changeset
488 (@code{dired-expunge}) deletes all @dfn{flagged} files.
Dave Love <fx@gnu.org>
parents:
diff changeset
489
Dave Love <fx@gnu.org>
parents:
diff changeset
490 @findex dired-do-rename
Dave Love <fx@gnu.org>
parents:
diff changeset
491 @kindex R @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
492 @cindex renaming files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
493 @item R @var{new} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
494 Rename the specified files (@code{dired-do-rename}). The argument
Dave Love <fx@gnu.org>
parents:
diff changeset
495 @var{new} is the directory to rename into, or (if renaming a single
Dave Love <fx@gnu.org>
parents:
diff changeset
496 file) the new name.
Dave Love <fx@gnu.org>
parents:
diff changeset
497
Dave Love <fx@gnu.org>
parents:
diff changeset
498 Dired automatically changes the visited file name of buffers associated
Dave Love <fx@gnu.org>
parents:
diff changeset
499 with renamed files so that they refer to the new names.
Dave Love <fx@gnu.org>
parents:
diff changeset
500
Dave Love <fx@gnu.org>
parents:
diff changeset
501 @findex dired-do-hardlink
Dave Love <fx@gnu.org>
parents:
diff changeset
502 @kindex H @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
503 @cindex hard links (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
504 @item H @var{new} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
505 Make hard links to the specified files (@code{dired-do-hardlink}). The
Dave Love <fx@gnu.org>
parents:
diff changeset
506 argument @var{new} is the directory to make the links in, or (if making
Dave Love <fx@gnu.org>
parents:
diff changeset
507 just one link) the name to give the link.
Dave Love <fx@gnu.org>
parents:
diff changeset
508
Dave Love <fx@gnu.org>
parents:
diff changeset
509 @findex dired-do-symlink
Dave Love <fx@gnu.org>
parents:
diff changeset
510 @kindex S @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
511 @cindex symlinks (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
512 @item S @var{new} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
513 Make symbolic links to the specified files (@code{dired-do-symlink}).
Dave Love <fx@gnu.org>
parents:
diff changeset
514 The argument @var{new} is the directory to make the links in, or (if
Dave Love <fx@gnu.org>
parents:
diff changeset
515 making just one link) the name to give the link.
Dave Love <fx@gnu.org>
parents:
diff changeset
516
Dave Love <fx@gnu.org>
parents:
diff changeset
517 @findex dired-do-chmod
Dave Love <fx@gnu.org>
parents:
diff changeset
518 @kindex M @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
519 @cindex changing file permissions (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
520 @item M @var{modespec} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
521 Change the mode (also called ``permission bits'') of the specified files
Dave Love <fx@gnu.org>
parents:
diff changeset
522 (@code{dired-do-chmod}). This uses the @code{chmod} program, so
Dave Love <fx@gnu.org>
parents:
diff changeset
523 @var{modespec} can be any argument that @code{chmod} can handle.
Dave Love <fx@gnu.org>
parents:
diff changeset
524
Dave Love <fx@gnu.org>
parents:
diff changeset
525 @findex dired-do-chgrp
Dave Love <fx@gnu.org>
parents:
diff changeset
526 @kindex G @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
527 @cindex changing file group ownership (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
528 @item G @var{newgroup} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
529 Change the group of the specified files to @var{newgroup}
Dave Love <fx@gnu.org>
parents:
diff changeset
530 (@code{dired-do-chgrp}).
Dave Love <fx@gnu.org>
parents:
diff changeset
531
Dave Love <fx@gnu.org>
parents:
diff changeset
532 @findex dired-do-chown
Dave Love <fx@gnu.org>
parents:
diff changeset
533 @kindex O @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
534 @cindex changing file owner (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
535 @item O @var{newowner} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
536 Change the owner of the specified files to @var{newowner}
Dave Love <fx@gnu.org>
parents:
diff changeset
537 (@code{dired-do-chown}). (On most systems, only the superuser can do
Dave Love <fx@gnu.org>
parents:
diff changeset
538 this.)
Dave Love <fx@gnu.org>
parents:
diff changeset
539
Dave Love <fx@gnu.org>
parents:
diff changeset
540 @vindex dired-chown-program
Dave Love <fx@gnu.org>
parents:
diff changeset
541 The variable @code{dired-chown-program} specifies the name of the
Dave Love <fx@gnu.org>
parents:
diff changeset
542 program to use to do the work (different systems put @code{chown} in
Dave Love <fx@gnu.org>
parents:
diff changeset
543 different places).
Dave Love <fx@gnu.org>
parents:
diff changeset
544
Dave Love <fx@gnu.org>
parents:
diff changeset
545 @findex dired-do-print
Dave Love <fx@gnu.org>
parents:
diff changeset
546 @kindex P @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
547 @cindex printing files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
548 @item P @var{command} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
549 Print the specified files (@code{dired-do-print}). You must specify the
Dave Love <fx@gnu.org>
parents:
diff changeset
550 command to print them with, but the minibuffer starts out with a
Dave Love <fx@gnu.org>
parents:
diff changeset
551 suitable guess made using the variables @code{lpr-command} and
Dave Love <fx@gnu.org>
parents:
diff changeset
552 @code{lpr-switches} (the same variables that @code{lpr-buffer} uses;
Dave Love <fx@gnu.org>
parents:
diff changeset
553 @pxref{Hardcopy}).
Dave Love <fx@gnu.org>
parents:
diff changeset
554
Dave Love <fx@gnu.org>
parents:
diff changeset
555 @findex dired-do-compress
Dave Love <fx@gnu.org>
parents:
diff changeset
556 @kindex Z @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
557 @cindex compressing files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
558 @item Z
Dave Love <fx@gnu.org>
parents:
diff changeset
559 Compress the specified files (@code{dired-do-compress}). If the file
Dave Love <fx@gnu.org>
parents:
diff changeset
560 appears to be a compressed file already, it is uncompressed instead.
Dave Love <fx@gnu.org>
parents:
diff changeset
561
Dave Love <fx@gnu.org>
parents:
diff changeset
562 @findex dired-do-load
Dave Love <fx@gnu.org>
parents:
diff changeset
563 @kindex L @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
564 @cindex loading several files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
565 @item L
Dave Love <fx@gnu.org>
parents:
diff changeset
566 Load the specified Emacs Lisp files (@code{dired-do-load}).
Dave Love <fx@gnu.org>
parents:
diff changeset
567 @xref{Lisp Libraries}.
Dave Love <fx@gnu.org>
parents:
diff changeset
568
Dave Love <fx@gnu.org>
parents:
diff changeset
569 @findex dired-do-byte-compile
Dave Love <fx@gnu.org>
parents:
diff changeset
570 @kindex B @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
571 @cindex byte-compiling several files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
572 @item B
Dave Love <fx@gnu.org>
parents:
diff changeset
573 Byte compile the specified Emacs Lisp files
Dave Love <fx@gnu.org>
parents:
diff changeset
574 (@code{dired-do-byte-compile}). @xref{Byte Compilation,, Byte
Dave Love <fx@gnu.org>
parents:
diff changeset
575 Compilation, elisp, The Emacs Lisp Reference Manual}.
Dave Love <fx@gnu.org>
parents:
diff changeset
576
Dave Love <fx@gnu.org>
parents:
diff changeset
577 @kindex A @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
578 @findex dired-do-search
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
579 @cindex search multiple files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
580 @item A @var{regexp} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
581 Search all the specified files for the regular expression @var{regexp}
Dave Love <fx@gnu.org>
parents:
diff changeset
582 (@code{dired-do-search}).
Dave Love <fx@gnu.org>
parents:
diff changeset
583
Dave Love <fx@gnu.org>
parents:
diff changeset
584 This command is a variant of @code{tags-search}. The search stops at
Dave Love <fx@gnu.org>
parents:
diff changeset
585 the first match it finds; use @kbd{M-,} to resume the search and find
Dave Love <fx@gnu.org>
parents:
diff changeset
586 the next match. @xref{Tags Search}.
Dave Love <fx@gnu.org>
parents:
diff changeset
587
Dave Love <fx@gnu.org>
parents:
diff changeset
588 @kindex Q @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
589 @findex dired-do-query-replace
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
590 @cindex search and replace in multiple files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
591 @item Q @var{from} @key{RET} @var{to} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
592 Perform @code{query-replace-regexp} on each of the specified files,
Dave Love <fx@gnu.org>
parents:
diff changeset
593 replacing matches for @var{from} (a regular expression) with the string
Dave Love <fx@gnu.org>
parents:
diff changeset
594 @var{to} (@code{dired-do-query-replace}).
Dave Love <fx@gnu.org>
parents:
diff changeset
595
Dave Love <fx@gnu.org>
parents:
diff changeset
596 This command is a variant of @code{tags-query-replace}. If you exit the
Dave Love <fx@gnu.org>
parents:
diff changeset
597 query replace loop, you can use @kbd{M-,} to resume the scan and replace
Dave Love <fx@gnu.org>
parents:
diff changeset
598 more matches. @xref{Tags Search}.
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
599
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
600 @kindex a @r{(Dired)}
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
601 @findex dired-do-apply
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
602 @cindex apply arbitrary function to many files
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
603 @item a @var{function} @kbd{RET}
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
604 Apply an arbitrary Lisp function to the name of each marked file
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
605 (@code{dired-do-apply}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
606 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
607
Dave Love <fx@gnu.org>
parents:
diff changeset
608 @kindex + @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
609 @findex dired-create-directory
Dave Love <fx@gnu.org>
parents:
diff changeset
610 One special file-operation command is @kbd{+}
Dave Love <fx@gnu.org>
parents:
diff changeset
611 (@code{dired-create-directory}). This command reads a directory name and
Dave Love <fx@gnu.org>
parents:
diff changeset
612 creates the directory if it does not already exist.
Dave Love <fx@gnu.org>
parents:
diff changeset
613
Dave Love <fx@gnu.org>
parents:
diff changeset
614 @node Shell Commands in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
615 @section Shell Commands in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
616 @cindex shell commands, Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
617
Dave Love <fx@gnu.org>
parents:
diff changeset
618 @findex dired-do-shell-command
Dave Love <fx@gnu.org>
parents:
diff changeset
619 @kindex ! @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
620 The dired command @kbd{!} (@code{dired-do-shell-command}) reads a shell
Dave Love <fx@gnu.org>
parents:
diff changeset
621 command string in the minibuffer and runs that shell command on all the
Dave Love <fx@gnu.org>
parents:
diff changeset
622 specified files. You can specify the files to operate on in the usual
Dave Love <fx@gnu.org>
parents:
diff changeset
623 ways for Dired commands (@pxref{Operating on Files}). There are two
Dave Love <fx@gnu.org>
parents:
diff changeset
624 ways of applying a shell command to multiple files:
Dave Love <fx@gnu.org>
parents:
diff changeset
625
Dave Love <fx@gnu.org>
parents:
diff changeset
626 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
627 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
628 If you use @samp{*} in the shell command, then it runs just once, with
Dave Love <fx@gnu.org>
parents:
diff changeset
629 the list of file names substituted for the @samp{*}. The order of file
Dave Love <fx@gnu.org>
parents:
diff changeset
630 names is the order of appearance in the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
631
Dave Love <fx@gnu.org>
parents:
diff changeset
632 Thus, @kbd{! tar cf foo.tar * @key{RET}} runs @code{tar} on the entire
Dave Love <fx@gnu.org>
parents:
diff changeset
633 list of file names, putting them into one tar file @file{foo.tar}.
Dave Love <fx@gnu.org>
parents:
diff changeset
634
Dave Love <fx@gnu.org>
parents:
diff changeset
635 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
636 If the command string doesn't contain @samp{*}, then it runs once
Dave Love <fx@gnu.org>
parents:
diff changeset
637 @emph{for each file}, with the file name added at the end.
Dave Love <fx@gnu.org>
parents:
diff changeset
638
Dave Love <fx@gnu.org>
parents:
diff changeset
639 For example, @kbd{! uudecode @key{RET}} runs @code{uudecode} on each
Dave Love <fx@gnu.org>
parents:
diff changeset
640 file.
Dave Love <fx@gnu.org>
parents:
diff changeset
641 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
642
Dave Love <fx@gnu.org>
parents:
diff changeset
643 What if you want to run the shell command once for each file but with
Dave Love <fx@gnu.org>
parents:
diff changeset
644 the file name inserted in the middle? Or if you want to use the file
Dave Love <fx@gnu.org>
parents:
diff changeset
645 names in a more complicated fashion? Use a shell loop. For example,
Dave Love <fx@gnu.org>
parents:
diff changeset
646 this shell command would run @code{uuencode} on each of the specified
Dave Love <fx@gnu.org>
parents:
diff changeset
647 files, writing the output into a corresponding @file{.uu} file:
Dave Love <fx@gnu.org>
parents:
diff changeset
648
Dave Love <fx@gnu.org>
parents:
diff changeset
649 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
650 for file in *; do uuencode $file $file >$file.uu; done
Dave Love <fx@gnu.org>
parents:
diff changeset
651 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
652
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
653 @noindent
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
654 In simple cases you can instead use @samp{?} in the command. This is
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
655 similar to @samp{*} but the command will be run on each file
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
656 individually.
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
657
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
658 The working directory for the shell command is the top-level directory
Dave Love <fx@gnu.org>
parents:
diff changeset
659 of the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
660
Dave Love <fx@gnu.org>
parents:
diff changeset
661 The @kbd{!} command does not attempt to update the Dired buffer to show
Dave Love <fx@gnu.org>
parents:
diff changeset
662 new or modified files, because it doesn't really understand shell
Dave Love <fx@gnu.org>
parents:
diff changeset
663 commands, and does not know what files the shell command changed. Use
Dave Love <fx@gnu.org>
parents:
diff changeset
664 the @kbd{g} command to update the Dired buffer (@pxref{Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
665 Updating}).
Dave Love <fx@gnu.org>
parents:
diff changeset
666
Dave Love <fx@gnu.org>
parents:
diff changeset
667 @node Transforming File Names
Dave Love <fx@gnu.org>
parents:
diff changeset
668 @section Transforming File Names in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
669
Dave Love <fx@gnu.org>
parents:
diff changeset
670 Here are commands that alter file names in a systematic way:
Dave Love <fx@gnu.org>
parents:
diff changeset
671
Dave Love <fx@gnu.org>
parents:
diff changeset
672 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
673 @findex dired-upcase
Dave Love <fx@gnu.org>
parents:
diff changeset
674 @kindex % u @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
675 @cindex upcase file names
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
676 @item % u
Dave Love <fx@gnu.org>
parents:
diff changeset
677 Rename each of the selected files to an upper-case name
Dave Love <fx@gnu.org>
parents:
diff changeset
678 (@code{dired-upcase}). If the old file names are @file{Foo}
Dave Love <fx@gnu.org>
parents:
diff changeset
679 and @file{bar}, the new names are @file{FOO} and @file{BAR}.
Dave Love <fx@gnu.org>
parents:
diff changeset
680
Dave Love <fx@gnu.org>
parents:
diff changeset
681 @item % l
Dave Love <fx@gnu.org>
parents:
diff changeset
682 @findex dired-downcase
Dave Love <fx@gnu.org>
parents:
diff changeset
683 @kindex % l @r{(Dired)}
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
684 @cindex downcase file names
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
685 Rename each of the selected files to a lower-case name
Dave Love <fx@gnu.org>
parents:
diff changeset
686 (@code{dired-downcase}). If the old file names are @file{Foo} and
Dave Love <fx@gnu.org>
parents:
diff changeset
687 @file{bar}, the new names are @file{foo} and @file{bar}.
Dave Love <fx@gnu.org>
parents:
diff changeset
688
Dave Love <fx@gnu.org>
parents:
diff changeset
689 @item % R @var{from} @key{RET} @var{to} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
690 @kindex % R @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
691 @findex dired-do-rename-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
692 @itemx % C @var{from} @key{RET} @var{to} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
693 @kindex % C @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
694 @findex dired-do-copy-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
695 @itemx % H @var{from} @key{RET} @var{to} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
696 @kindex % H @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
697 @findex dired-do-hardlink-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
698 @itemx % S @var{from} @key{RET} @var{to} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
699 @kindex % S @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
700 @findex dired-do-symlink-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
701 These four commands rename, copy, make hard links and make soft links,
Dave Love <fx@gnu.org>
parents:
diff changeset
702 in each case computing the new name by regular-expression substitution
Dave Love <fx@gnu.org>
parents:
diff changeset
703 from the name of the old file.
Dave Love <fx@gnu.org>
parents:
diff changeset
704 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
705
Dave Love <fx@gnu.org>
parents:
diff changeset
706 The four regular-expression substitution commands effectively perform
Dave Love <fx@gnu.org>
parents:
diff changeset
707 a search-and-replace on the selected file names in the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
708 They read two arguments: a regular expression @var{from}, and a
Dave Love <fx@gnu.org>
parents:
diff changeset
709 substitution pattern @var{to}.
Dave Love <fx@gnu.org>
parents:
diff changeset
710
Dave Love <fx@gnu.org>
parents:
diff changeset
711 The commands match each ``old'' file name against the regular
Dave Love <fx@gnu.org>
parents:
diff changeset
712 expression @var{from}, and then replace the matching part with @var{to}.
Dave Love <fx@gnu.org>
parents:
diff changeset
713 You can use @samp{\&} and @samp{\@var{digit}} in @var{to} to refer to
Dave Love <fx@gnu.org>
parents:
diff changeset
714 all or part of what the pattern matched in the old file name, as in
Dave Love <fx@gnu.org>
parents:
diff changeset
715 @code{replace-regexp} (@pxref{Regexp Replace}). If the regular expression
Dave Love <fx@gnu.org>
parents:
diff changeset
716 matches more than once in a file name, only the first match is replaced.
Dave Love <fx@gnu.org>
parents:
diff changeset
717
Dave Love <fx@gnu.org>
parents:
diff changeset
718 For example, @kbd{% R ^.*$ @key{RET} x-\& @key{RET}} renames each
Dave Love <fx@gnu.org>
parents:
diff changeset
719 selected file by prepending @samp{x-} to its name. The inverse of this,
Dave Love <fx@gnu.org>
parents:
diff changeset
720 removing @samp{x-} from the front of each file name, is also possible:
Dave Love <fx@gnu.org>
parents:
diff changeset
721 one method is @kbd{% R ^x-\(.*\)$ @key{RET} \1 @key{RET}}; another is
Dave Love <fx@gnu.org>
parents:
diff changeset
722 @kbd{% R ^x- @key{RET} @key{RET}}. (Use @samp{^} and @samp{$} to anchor
Dave Love <fx@gnu.org>
parents:
diff changeset
723 matches that should span the whole filename.)
Dave Love <fx@gnu.org>
parents:
diff changeset
724
Dave Love <fx@gnu.org>
parents:
diff changeset
725 Normally, the replacement process does not consider the files'
Dave Love <fx@gnu.org>
parents:
diff changeset
726 directory names; it operates on the file name within the directory. If
Dave Love <fx@gnu.org>
parents:
diff changeset
727 you specify a numeric argument of zero, then replacement affects the
Dave Love <fx@gnu.org>
parents:
diff changeset
728 entire absolute file name including directory name.
Dave Love <fx@gnu.org>
parents:
diff changeset
729
Dave Love <fx@gnu.org>
parents:
diff changeset
730 Often you will want to select the set of files to operate on using the
Dave Love <fx@gnu.org>
parents:
diff changeset
731 same @var{regexp} that you will use to operate on them. To do this,
Dave Love <fx@gnu.org>
parents:
diff changeset
732 mark those files with @kbd{% m @var{regexp} @key{RET}}, then use the
Dave Love <fx@gnu.org>
parents:
diff changeset
733 same regular expression in the command to operate on the files. To make
Dave Love <fx@gnu.org>
parents:
diff changeset
734 this easier, the @kbd{%} commands to operate on files use the last
Dave Love <fx@gnu.org>
parents:
diff changeset
735 regular expression specified in any @kbd{%} command as a default.
Dave Love <fx@gnu.org>
parents:
diff changeset
736
Dave Love <fx@gnu.org>
parents:
diff changeset
737 @node Comparison in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
738 @section File Comparison with Dired
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
739 @cindex file comparison (in Dired)
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
740 @cindex compare files (in Dired)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
741
Dave Love <fx@gnu.org>
parents:
diff changeset
742 Here are two Dired commands that compare specified files using
Dave Love <fx@gnu.org>
parents:
diff changeset
743 @code{diff}.
Dave Love <fx@gnu.org>
parents:
diff changeset
744
Dave Love <fx@gnu.org>
parents:
diff changeset
745 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
746 @item =
Dave Love <fx@gnu.org>
parents:
diff changeset
747 @findex dired-diff
Dave Love <fx@gnu.org>
parents:
diff changeset
748 @kindex = @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
749 Compare the current file (the file at point) with another file (the file
Dave Love <fx@gnu.org>
parents:
diff changeset
750 at the mark) using the @code{diff} program (@code{dired-diff}). The
Dave Love <fx@gnu.org>
parents:
diff changeset
751 file at the mark is the first argument of @code{diff}, and the file at
Dave Love <fx@gnu.org>
parents:
diff changeset
752 point is the second argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
753
Dave Love <fx@gnu.org>
parents:
diff changeset
754 @findex dired-backup-diff
Dave Love <fx@gnu.org>
parents:
diff changeset
755 @kindex M-= @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
756 @item M-=
Dave Love <fx@gnu.org>
parents:
diff changeset
757 Compare the current file with its latest backup file
Dave Love <fx@gnu.org>
parents:
diff changeset
758 (@code{dired-backup-diff}). If the current file is itself a backup,
Dave Love <fx@gnu.org>
parents:
diff changeset
759 compare it with the file it is a backup of; this way, you can compare
Dave Love <fx@gnu.org>
parents:
diff changeset
760 a file with any backup version of your choice.
Dave Love <fx@gnu.org>
parents:
diff changeset
761
Dave Love <fx@gnu.org>
parents:
diff changeset
762 The backup file is the first file given to @code{diff}.
Dave Love <fx@gnu.org>
parents:
diff changeset
763 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
764
Dave Love <fx@gnu.org>
parents:
diff changeset
765 @node Subdirectories in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
766 @section Subdirectories in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
767 @cindex subdirectories in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
768 @cindex expanding subdirectories in Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
769
Dave Love <fx@gnu.org>
parents:
diff changeset
770 A Dired buffer displays just one directory in the normal case;
Dave Love <fx@gnu.org>
parents:
diff changeset
771 but you can optionally include its subdirectories as well.
Dave Love <fx@gnu.org>
parents:
diff changeset
772
Dave Love <fx@gnu.org>
parents:
diff changeset
773 The simplest way to include multiple directories in one Dired buffer is
Dave Love <fx@gnu.org>
parents:
diff changeset
774 to specify the options @samp{-lR} for running @code{ls}. (If you give a
Dave Love <fx@gnu.org>
parents:
diff changeset
775 numeric argument when you run Dired, then you can specify these options
Dave Love <fx@gnu.org>
parents:
diff changeset
776 in the minibuffer.) That produces a recursive directory listing showing
Dave Love <fx@gnu.org>
parents:
diff changeset
777 all subdirectories at all levels.
Dave Love <fx@gnu.org>
parents:
diff changeset
778
Dave Love <fx@gnu.org>
parents:
diff changeset
779 But usually all the subdirectories are too many; usually you will
Dave Love <fx@gnu.org>
parents:
diff changeset
780 prefer to include specific subdirectories only. You can do this with
Dave Love <fx@gnu.org>
parents:
diff changeset
781 the @kbd{i} command:
Dave Love <fx@gnu.org>
parents:
diff changeset
782
Dave Love <fx@gnu.org>
parents:
diff changeset
783 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
784 @findex dired-maybe-insert-subdir
Dave Love <fx@gnu.org>
parents:
diff changeset
785 @kindex i @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
786 @item i
Dave Love <fx@gnu.org>
parents:
diff changeset
787 @cindex inserted subdirectory (Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
788 @cindex in-situ subdirectory (Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
789 Insert the contents of a subdirectory later in the buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
790 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
791
Dave Love <fx@gnu.org>
parents:
diff changeset
792 Use the @kbd{i} (@code{dired-maybe-insert-subdir}) command on a line
Dave Love <fx@gnu.org>
parents:
diff changeset
793 that describes a file which is a directory. It inserts the contents of
Dave Love <fx@gnu.org>
parents:
diff changeset
794 that directory into the same Dired buffer, and moves there. Inserted
Dave Love <fx@gnu.org>
parents:
diff changeset
795 subdirectory contents follow the top-level directory of the Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
796 buffer, just as they do in @samp{ls -lR} output.
Dave Love <fx@gnu.org>
parents:
diff changeset
797
Dave Love <fx@gnu.org>
parents:
diff changeset
798 If the subdirectory's contents are already present in the buffer, the
Dave Love <fx@gnu.org>
parents:
diff changeset
799 @kbd{i} command just moves to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
800
Dave Love <fx@gnu.org>
parents:
diff changeset
801 In either case, @kbd{i} sets the Emacs mark before moving, so @kbd{C-u
Dave Love <fx@gnu.org>
parents:
diff changeset
802 C-@key{SPC}} takes you back to the old position in the buffer (the line
Dave Love <fx@gnu.org>
parents:
diff changeset
803 describing that subdirectory).
Dave Love <fx@gnu.org>
parents:
diff changeset
804
Dave Love <fx@gnu.org>
parents:
diff changeset
805 Use the @kbd{l} command (@code{dired-do-redisplay}) to update the
Dave Love <fx@gnu.org>
parents:
diff changeset
806 subdirectory's contents. Use @kbd{k} to delete the subdirectory.
Dave Love <fx@gnu.org>
parents:
diff changeset
807 @xref{Dired Updating}.
Dave Love <fx@gnu.org>
parents:
diff changeset
808
Dave Love <fx@gnu.org>
parents:
diff changeset
809 @node Subdirectory Motion
Dave Love <fx@gnu.org>
parents:
diff changeset
810 @section Moving Over Subdirectories
Dave Love <fx@gnu.org>
parents:
diff changeset
811
Dave Love <fx@gnu.org>
parents:
diff changeset
812 When a Dired buffer lists subdirectories, you can use the page motion
Dave Love <fx@gnu.org>
parents:
diff changeset
813 commands @kbd{C-x [} and @kbd{C-x ]} to move by entire directories.
Dave Love <fx@gnu.org>
parents:
diff changeset
814
Dave Love <fx@gnu.org>
parents:
diff changeset
815 @cindex header line (Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
816 @cindex directory header lines
Dave Love <fx@gnu.org>
parents:
diff changeset
817 The following commands move across, up and down in the tree of
Dave Love <fx@gnu.org>
parents:
diff changeset
818 directories within one Dired buffer. They move to @dfn{directory header
Dave Love <fx@gnu.org>
parents:
diff changeset
819 lines}, which are the lines that give a directory's name, at the
Dave Love <fx@gnu.org>
parents:
diff changeset
820 beginning of the directory's contents.
Dave Love <fx@gnu.org>
parents:
diff changeset
821
Dave Love <fx@gnu.org>
parents:
diff changeset
822 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
823 @findex dired-next-subdir
Dave Love <fx@gnu.org>
parents:
diff changeset
824 @kindex C-M-n @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
825 @item C-M-n
Dave Love <fx@gnu.org>
parents:
diff changeset
826 Go to next subdirectory header line, regardless of level
Dave Love <fx@gnu.org>
parents:
diff changeset
827 (@code{dired-next-subdir}).
Dave Love <fx@gnu.org>
parents:
diff changeset
828
Dave Love <fx@gnu.org>
parents:
diff changeset
829 @findex dired-prev-subdir
Dave Love <fx@gnu.org>
parents:
diff changeset
830 @kindex C-M-p @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
831 @item C-M-p
Dave Love <fx@gnu.org>
parents:
diff changeset
832 Go to previous subdirectory header line, regardless of level
Dave Love <fx@gnu.org>
parents:
diff changeset
833 (@code{dired-prev-subdir}).
Dave Love <fx@gnu.org>
parents:
diff changeset
834
Dave Love <fx@gnu.org>
parents:
diff changeset
835 @findex dired-tree-up
Dave Love <fx@gnu.org>
parents:
diff changeset
836 @kindex C-M-u @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
837 @item C-M-u
Dave Love <fx@gnu.org>
parents:
diff changeset
838 Go up to the parent directory's header line (@code{dired-tree-up}).
Dave Love <fx@gnu.org>
parents:
diff changeset
839
Dave Love <fx@gnu.org>
parents:
diff changeset
840 @findex dired-tree-down
Dave Love <fx@gnu.org>
parents:
diff changeset
841 @kindex C-M-d @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
842 @item C-M-d
Dave Love <fx@gnu.org>
parents:
diff changeset
843 Go down in the directory tree, to the first subdirectory's header line
Dave Love <fx@gnu.org>
parents:
diff changeset
844 (@code{dired-tree-down}).
Dave Love <fx@gnu.org>
parents:
diff changeset
845
Dave Love <fx@gnu.org>
parents:
diff changeset
846 @findex dired-prev-dirline
Dave Love <fx@gnu.org>
parents:
diff changeset
847 @kindex < @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
848 @item <
Dave Love <fx@gnu.org>
parents:
diff changeset
849 Move up to the previous directory-file line (@code{dired-prev-dirline}).
Dave Love <fx@gnu.org>
parents:
diff changeset
850 These lines are the ones that describe a directory as a file in its
Dave Love <fx@gnu.org>
parents:
diff changeset
851 parent directory.
Dave Love <fx@gnu.org>
parents:
diff changeset
852
Dave Love <fx@gnu.org>
parents:
diff changeset
853 @findex dired-next-dirline
Dave Love <fx@gnu.org>
parents:
diff changeset
854 @kindex > @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
855 @item >
Dave Love <fx@gnu.org>
parents:
diff changeset
856 Move down to the next directory-file line (@code{dired-prev-dirline}).
Dave Love <fx@gnu.org>
parents:
diff changeset
857 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
858
Dave Love <fx@gnu.org>
parents:
diff changeset
859 @node Hiding Subdirectories
Dave Love <fx@gnu.org>
parents:
diff changeset
860 @section Hiding Subdirectories
Dave Love <fx@gnu.org>
parents:
diff changeset
861
Dave Love <fx@gnu.org>
parents:
diff changeset
862 @cindex hiding in Dired (Dired)
Dave Love <fx@gnu.org>
parents:
diff changeset
863 @dfn{Hiding} a subdirectory means to make it invisible, except for its
Dave Love <fx@gnu.org>
parents:
diff changeset
864 header line, via selective display (@pxref{Selective Display}).
Dave Love <fx@gnu.org>
parents:
diff changeset
865
Dave Love <fx@gnu.org>
parents:
diff changeset
866 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
867 @item $
Dave Love <fx@gnu.org>
parents:
diff changeset
868 @findex dired-hide-subdir
Dave Love <fx@gnu.org>
parents:
diff changeset
869 @kindex $ @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
870 Hide or reveal the subdirectory that point is in, and move point to the
Dave Love <fx@gnu.org>
parents:
diff changeset
871 next subdirectory (@code{dired-hide-subdir}). A numeric argument serves
Dave Love <fx@gnu.org>
parents:
diff changeset
872 as a repeat count.
Dave Love <fx@gnu.org>
parents:
diff changeset
873
Dave Love <fx@gnu.org>
parents:
diff changeset
874 @item M-$
Dave Love <fx@gnu.org>
parents:
diff changeset
875 @findex dired-hide-all
Dave Love <fx@gnu.org>
parents:
diff changeset
876 @kindex M-$ @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
877 Hide all subdirectories in this Dired buffer, leaving only their header
Dave Love <fx@gnu.org>
parents:
diff changeset
878 lines (@code{dired-hide-all}). Or, if any subdirectory is currently
Dave Love <fx@gnu.org>
parents:
diff changeset
879 hidden, make all subdirectories visible again. You can use this command
Dave Love <fx@gnu.org>
parents:
diff changeset
880 to get an overview in very deep directory trees or to move quickly to
Dave Love <fx@gnu.org>
parents:
diff changeset
881 subdirectories far away.
Dave Love <fx@gnu.org>
parents:
diff changeset
882 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
883
Dave Love <fx@gnu.org>
parents:
diff changeset
884 Ordinary Dired commands never consider files inside a hidden
Dave Love <fx@gnu.org>
parents:
diff changeset
885 subdirectory. For example, the commands to operate on marked files
Dave Love <fx@gnu.org>
parents:
diff changeset
886 ignore files in hidden directories even if they are marked. Thus you
Dave Love <fx@gnu.org>
parents:
diff changeset
887 can use hiding to temporarily exclude subdirectories from operations
Dave Love <fx@gnu.org>
parents:
diff changeset
888 without having to remove the markers.
Dave Love <fx@gnu.org>
parents:
diff changeset
889
Dave Love <fx@gnu.org>
parents:
diff changeset
890 The subdirectory hiding commands toggle; that is, they hide what was
Dave Love <fx@gnu.org>
parents:
diff changeset
891 visible, and show what was hidden.
Dave Love <fx@gnu.org>
parents:
diff changeset
892
Dave Love <fx@gnu.org>
parents:
diff changeset
893 @node Dired Updating
Dave Love <fx@gnu.org>
parents:
diff changeset
894 @section Updating the Dired Buffer
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
895 @cindex updating Dired buffer
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
896 @cindex refreshing displayed files
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
897
Dave Love <fx@gnu.org>
parents:
diff changeset
898 This section describes commands to update the Dired buffer to reflect
Dave Love <fx@gnu.org>
parents:
diff changeset
899 outside (non-Dired) changes in the directories and files, and to delete
Dave Love <fx@gnu.org>
parents:
diff changeset
900 part of the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
901
Dave Love <fx@gnu.org>
parents:
diff changeset
902 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
903 @item g
Dave Love <fx@gnu.org>
parents:
diff changeset
904 Update the entire contents of the Dired buffer (@code{revert-buffer}).
Dave Love <fx@gnu.org>
parents:
diff changeset
905
Dave Love <fx@gnu.org>
parents:
diff changeset
906 @item l
Dave Love <fx@gnu.org>
parents:
diff changeset
907 Update the specified files (@code{dired-do-redisplay}).
Dave Love <fx@gnu.org>
parents:
diff changeset
908
Dave Love <fx@gnu.org>
parents:
diff changeset
909 @item k
Dave Love <fx@gnu.org>
parents:
diff changeset
910 Delete the specified @emph{file lines}---not the files, just the lines
Dave Love <fx@gnu.org>
parents:
diff changeset
911 (@code{dired-do-kill-lines}).
Dave Love <fx@gnu.org>
parents:
diff changeset
912
Dave Love <fx@gnu.org>
parents:
diff changeset
913 @item s
Dave Love <fx@gnu.org>
parents:
diff changeset
914 Toggle between alphabetical order and date/time order
Dave Love <fx@gnu.org>
parents:
diff changeset
915 (@code{dired-sort-toggle-or-edit}).
Dave Love <fx@gnu.org>
parents:
diff changeset
916
Dave Love <fx@gnu.org>
parents:
diff changeset
917 @item C-u s @var{switches} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
918 Refresh the Dired buffer using @var{switches} as
Dave Love <fx@gnu.org>
parents:
diff changeset
919 @code{dired-listing-switches}.
Dave Love <fx@gnu.org>
parents:
diff changeset
920 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
921
Dave Love <fx@gnu.org>
parents:
diff changeset
922 @kindex g @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
923 @findex revert-buffer @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
924 Type @kbd{g} (@code{revert-buffer}) to update the contents of the
Dave Love <fx@gnu.org>
parents:
diff changeset
925 Dired buffer, based on changes in the files and directories listed.
Dave Love <fx@gnu.org>
parents:
diff changeset
926 This preserves all marks except for those on files that have vanished.
Dave Love <fx@gnu.org>
parents:
diff changeset
927 Hidden subdirectories are updated but remain hidden.
Dave Love <fx@gnu.org>
parents:
diff changeset
928
Dave Love <fx@gnu.org>
parents:
diff changeset
929 @kindex l @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
930 @findex dired-do-redisplay
Dave Love <fx@gnu.org>
parents:
diff changeset
931 To update only some of the files, type @kbd{l}
Dave Love <fx@gnu.org>
parents:
diff changeset
932 (@code{dired-do-redisplay}). This command applies to the next @var{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
933 files, or to the marked files if any, or to the current file. Updating
Dave Love <fx@gnu.org>
parents:
diff changeset
934 them means reading their current status from the file system and
Dave Love <fx@gnu.org>
parents:
diff changeset
935 changing the buffer to reflect it properly.
Dave Love <fx@gnu.org>
parents:
diff changeset
936
Dave Love <fx@gnu.org>
parents:
diff changeset
937 If you use @kbd{l} on a subdirectory header line, it updates the
Dave Love <fx@gnu.org>
parents:
diff changeset
938 contents of the corresponding subdirectory.
Dave Love <fx@gnu.org>
parents:
diff changeset
939
Dave Love <fx@gnu.org>
parents:
diff changeset
940 @kindex k @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
941 @findex dired-do-kill-lines
Dave Love <fx@gnu.org>
parents:
diff changeset
942 To delete the specified @emph{file lines}---not the files, just the
Dave Love <fx@gnu.org>
parents:
diff changeset
943 lines---type @kbd{k} (@code{dired-do-kill-lines}). With a numeric
Dave Love <fx@gnu.org>
parents:
diff changeset
944 argument @var{n}, this command applies to the next @var{n} files;
Dave Love <fx@gnu.org>
parents:
diff changeset
945 otherwise, it applies to the marked files.
Dave Love <fx@gnu.org>
parents:
diff changeset
946
Dave Love <fx@gnu.org>
parents:
diff changeset
947 If you kill the line for a file that is a directory, the directory's
Dave Love <fx@gnu.org>
parents:
diff changeset
948 contents are also deleted from the buffer. Typing @kbd{C-u k} on the
Dave Love <fx@gnu.org>
parents:
diff changeset
949 header line for a subdirectory is another way to delete a subdirectory
Dave Love <fx@gnu.org>
parents:
diff changeset
950 from the Dired buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
951
Dave Love <fx@gnu.org>
parents:
diff changeset
952 The @kbd{g} command brings back any individual lines that you have
Dave Love <fx@gnu.org>
parents:
diff changeset
953 killed in this way, but not subdirectories---you must use @kbd{i} to
Dave Love <fx@gnu.org>
parents:
diff changeset
954 reinsert each subdirectory.
Dave Love <fx@gnu.org>
parents:
diff changeset
955
Dave Love <fx@gnu.org>
parents:
diff changeset
956 @cindex Dired sorting
Dave Love <fx@gnu.org>
parents:
diff changeset
957 @cindex sorting Dired buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
958 @kindex s @r{(Dired)}
Dave Love <fx@gnu.org>
parents:
diff changeset
959 @findex dired-sort-toggle-or-edit
Dave Love <fx@gnu.org>
parents:
diff changeset
960 The files in a Dired buffers are normally listed in alphabetical order
Dave Love <fx@gnu.org>
parents:
diff changeset
961 by file names. Alternatively Dired can sort them by date/time. The
Dave Love <fx@gnu.org>
parents:
diff changeset
962 Dired command @kbd{s} (@code{dired-sort-toggle-or-edit}) switches
Dave Love <fx@gnu.org>
parents:
diff changeset
963 between these two sorting modes. The mode line in a Dired buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
964 indicates which way it is currently sorted---by name, or by date.
Dave Love <fx@gnu.org>
parents:
diff changeset
965
Dave Love <fx@gnu.org>
parents:
diff changeset
966 @kbd{C-u s @var{switches} @key{RET}} lets you specify a new value for
Dave Love <fx@gnu.org>
parents:
diff changeset
967 @code{dired-listing-switches}.
Dave Love <fx@gnu.org>
parents:
diff changeset
968
Dave Love <fx@gnu.org>
parents:
diff changeset
969 @node Dired and Find
Dave Love <fx@gnu.org>
parents:
diff changeset
970 @section Dired and @code{find}
Dave Love <fx@gnu.org>
parents:
diff changeset
971 @cindex @code{find} and Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
972
Dave Love <fx@gnu.org>
parents:
diff changeset
973 You can select a set of files for display in a Dired buffer more
Dave Love <fx@gnu.org>
parents:
diff changeset
974 flexibly by using the @code{find} utility to choose the files.
Dave Love <fx@gnu.org>
parents:
diff changeset
975
Dave Love <fx@gnu.org>
parents:
diff changeset
976 @findex find-name-dired
Dave Love <fx@gnu.org>
parents:
diff changeset
977 To search for files with names matching a wildcard pattern use
Dave Love <fx@gnu.org>
parents:
diff changeset
978 @kbd{M-x find-name-dired}. It reads arguments @var{directory} and
Dave Love <fx@gnu.org>
parents:
diff changeset
979 @var{pattern}, and chooses all the files in @var{directory} or its
Dave Love <fx@gnu.org>
parents:
diff changeset
980 subdirectories whose individual names match @var{pattern}.
Dave Love <fx@gnu.org>
parents:
diff changeset
981
Dave Love <fx@gnu.org>
parents:
diff changeset
982 The files thus chosen are displayed in a Dired buffer in which the
Dave Love <fx@gnu.org>
parents:
diff changeset
983 ordinary Dired commands are available.
Dave Love <fx@gnu.org>
parents:
diff changeset
984
Dave Love <fx@gnu.org>
parents:
diff changeset
985 @findex find-grep-dired
Dave Love <fx@gnu.org>
parents:
diff changeset
986 If you want to test the contents of files, rather than their names,
Dave Love <fx@gnu.org>
parents:
diff changeset
987 use @kbd{M-x find-grep-dired}. This command reads two minibuffer
Dave Love <fx@gnu.org>
parents:
diff changeset
988 arguments, @var{directory} and @var{regexp}; it chooses all the files in
Dave Love <fx@gnu.org>
parents:
diff changeset
989 @var{directory} or its subdirectories that contain a match for
Dave Love <fx@gnu.org>
parents:
diff changeset
990 @var{regexp}. It works by running the programs @code{find} and
Dave Love <fx@gnu.org>
parents:
diff changeset
991 @code{grep}. See also @kbd{M-x grep-find}, in @ref{Compilation}.
Dave Love <fx@gnu.org>
parents:
diff changeset
992 Remember to write the regular expression for @code{grep}, not for Emacs.
35056
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
993 (An alternative method of showing files whose contents match a given
c9c43bb7f1d2 Add index entries for many Dired commands and features.
Eli Zaretskii <eliz@gnu.org>
parents: 30874
diff changeset
994 regexp is the @kbd{% g @var{regexp}} command, see @ref{Marks vs Flags}.)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
995
Dave Love <fx@gnu.org>
parents:
diff changeset
996 @findex find-dired
Dave Love <fx@gnu.org>
parents:
diff changeset
997 The most general command in this series is @kbd{M-x find-dired}, which
Dave Love <fx@gnu.org>
parents:
diff changeset
998 lets you specify any condition that @code{find} can test. It takes two
Dave Love <fx@gnu.org>
parents:
diff changeset
999 minibuffer arguments, @var{directory} and @var{find-args}; it runs
Dave Love <fx@gnu.org>
parents:
diff changeset
1000 @code{find} in @var{directory}, passing @var{find-args} to tell
Dave Love <fx@gnu.org>
parents:
diff changeset
1001 @code{find} what condition to test. To use this command, you need to
Dave Love <fx@gnu.org>
parents:
diff changeset
1002 know how to use @code{find}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1003
Dave Love <fx@gnu.org>
parents:
diff changeset
1004 @vindex find-ls-option
Dave Love <fx@gnu.org>
parents:
diff changeset
1005 The format of listing produced by these commands is controlled by the
Dave Love <fx@gnu.org>
parents:
diff changeset
1006 variable @code{find-ls-option}, whose default value specifies using
Dave Love <fx@gnu.org>
parents:
diff changeset
1007 options @samp{-ld} for @code{ls}. If your listings are corrupted, you
Dave Love <fx@gnu.org>
parents:
diff changeset
1008 may need to change the value of this variable.
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1009
30874
79e9f560240d dired-x tweaks
Dave Love <fx@gnu.org>
parents: 30114
diff changeset
1010 @node Dired Extra Features
79e9f560240d dired-x tweaks
Dave Love <fx@gnu.org>
parents: 30114
diff changeset
1011 @section Extra Features for Dired
27222
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1012
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1013 The Dired-X package provides various extra features for Dired mode. You
e7bd44d5597b Recursive deletes, copies. dired-do-apply. `?' in shell command.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1014 can load it with @code{M-x load-library} or customize
30874
79e9f560240d dired-x tweaks
Dave Love <fx@gnu.org>
parents: 30114
diff changeset
1015 @code{dired-load-hook} to add @code{dired-require-dired-x}.
79e9f560240d dired-x tweaks
Dave Love <fx@gnu.org>
parents: 30114
diff changeset
1016 @xref{,Dired-X,,dired-x, Dired Extra Version 2 User's Manual}.