|
25829
|
1 \input texinfo @comment -*-texinfo-*-
|
|
|
2
|
|
|
3 @c dired-x.texi --- Sebastian Kremer's Extra DIRED hacked up for GNU Emacs19
|
|
49600
|
4 @c
|
|
25829
|
5 @c Author: Sebastian Kremer <sk@thp.uni-koeln.de>
|
|
|
6 @c Lawrence R. Dodd <dodd@roebling.poly.edu>
|
|
28669
|
7 @c [Dodd's address no longer valid.]
|
|
36382
|
8 @c Version: 2.53
|
|
|
9 @c Date: 2001/02/25 14:05:46
|
|
25829
|
10 @c Keywords: dired extensions
|
|
|
11 @c dired-x.el REVISION NUMBER: 2
|
|
|
12
|
|
|
13 @c State: Released
|
|
36382
|
14 @c Ident: dired-x.texi,v 2.53 2001/02/25 14:05:46 dodd Released
|
|
25829
|
15
|
|
|
16 @comment %**start of header (This is for running Texinfo on a region.)
|
|
|
17 @c FOR GNU EMACS USE ../info/dired-x BELOW
|
|
|
18 @setfilename ../info/dired-x
|
|
|
19 @c dired-x.el REVISION NUMBER
|
|
|
20 @settitle Dired Extra Version 2 User's Manual
|
|
|
21 @iftex
|
|
|
22 @finalout
|
|
|
23 @end iftex
|
|
|
24 @c @setchapternewpage odd % For book style double sided manual.
|
|
|
25 @comment %**end of header (This is for running Texinfo on a region.)
|
|
|
26
|
|
47737
|
27 @copying
|
|
28669
|
28 This documents the ``extra'' features for Dired Mode for GNU Emacs found in
|
|
25829
|
29 the file @file{dired-x.el}.
|
|
|
30
|
|
64890
|
31 Copyright @copyright{} 1993, 1994, 2001, 2002, 2003, 2004,
|
|
69681
|
32 2005, 2006 Free Software Foundation, Inc.
|
|
25829
|
33
|
|
47737
|
34 @quotation
|
|
25829
|
35 Permission is granted to make and distribute verbatim copies of this
|
|
|
36 manual provided the copyright notice and this permission notice are
|
|
|
37 preserved on all copies.
|
|
|
38
|
|
|
39 Permission is granted to copy and distribute modified versions of
|
|
|
40 this manual under the conditions for verbatim copying, provided that
|
|
|
41 the entire resulting derived work is distributed under the terms of
|
|
|
42 a permission notice identical to this one.
|
|
|
43
|
|
|
44 Permission is granted to copy and distribute translations of this
|
|
|
45 manual into another language, under the above conditions for
|
|
|
46 modified versions, except that this permission notice may be stated
|
|
|
47 in a translation approved by the Free Software Foundation.
|
|
|
48
|
|
|
49 The file used to create this is called @file{dired-x.texi}, but the
|
|
|
50 original work that was altered to make that file was called
|
|
|
51 @file{dired.texi} written by Sebastian Kremer.
|
|
|
52
|
|
|
53 @ignore
|
|
|
54 Permission is granted to process this file through TeX and print the
|
|
|
55 results, provided the printed document carries copying permission
|
|
|
56 notice identical to this one except for the removal of this paragraph
|
|
|
57 (this paragraph not being relevant to the printed manual).
|
|
|
58
|
|
|
59 @end ignore
|
|
47737
|
60 @end quotation
|
|
|
61 @end copying
|
|
25829
|
62
|
|
47737
|
63 @dircategory Emacs
|
|
|
64 @direntry
|
|
|
65 * Dired-X: (dired-x). Dired Extra Features.
|
|
|
66 @end direntry
|
|
|
67
|
|
|
68 @c @smallbook
|
|
|
69 @tex
|
|
|
70 \overfullrule=0pt
|
|
|
71 %\global\baselineskip 30pt % For printing in double spaces
|
|
|
72 @end tex
|
|
|
73
|
|
25829
|
74 @titlepage
|
|
|
75 @sp 6
|
|
|
76 @c dired-x.el REVISION NUMBER
|
|
|
77 @center @titlefont{Dired Extra Version 2}
|
|
|
78 @sp 2
|
|
28669
|
79 @center @titlefont{For The GNU Emacs}
|
|
25829
|
80 @sp 1
|
|
|
81 @center @titlefont{Directory Editor}
|
|
|
82 @sp 4
|
|
36382
|
83 @center Manual Revision: 2.53
|
|
|
84 @center 2001/02/25 14:05:46
|
|
25829
|
85 @sp 5
|
|
|
86 @center Lawrence R@. Dodd
|
|
28669
|
87 @c @center @t{dodd@@roebling.poly.edu}
|
|
25829
|
88 @sp 5
|
|
|
89 @center (Based on @file{dired.texi} by Sebastian Kremer <sk@@thp.uni-koeln.de>)
|
|
|
90 @page
|
|
|
91 @vskip 0pt plus 1filll
|
|
47737
|
92 @insertcopying
|
|
25829
|
93 @end titlepage
|
|
|
94
|
|
|
95 @page
|
|
|
96
|
|
70801
|
97 @ifnottex
|
|
25829
|
98
|
|
47737
|
99 @node Top
|
|
25829
|
100 @comment node-name, next, previous, up
|
|
|
101
|
|
|
102 @noindent
|
|
28669
|
103 This documents the ``extra'' features for Dired Mode for GNU Emacs that are
|
|
25829
|
104 provided by the file @file{dired-x.el}.
|
|
|
105
|
|
|
106 @itemize @bullet
|
|
|
107
|
|
|
108 @item
|
|
|
109 Based on @file{dired.texi} by Sebastian Kremer <sk@@thp.uni-koeln.de>
|
|
|
110
|
|
|
111 @c dired-x.el REVISION NUMBER
|
|
49600
|
112 @item
|
|
25829
|
113 For @file{dired-x.el} revision 2
|
|
|
114
|
|
49600
|
115 @c @item
|
|
36382
|
116 @c Revision of this manual: 2.53 (2001/02/25 14:05:46)
|
|
25829
|
117
|
|
28669
|
118 @c @item
|
|
|
119 @c Bugs to Lawrence R. Dodd <dodd@@roebling.poly.edu>. @emph{Please} type
|
|
|
120 @c @kbd{M-x dired-x-submit-report} to submit a bug report (@pxref{Bugs}).
|
|
25829
|
121
|
|
28669
|
122 @c @item
|
|
|
123 @c You can obtain a copy of this package via anonymous ftp in
|
|
|
124 @c @t{/roebling.poly.edu:/pub/packages/dired-x.tar.gz}
|
|
25829
|
125
|
|
|
126 @end itemize
|
|
|
127
|
|
|
128 @menu
|
|
|
129 * Introduction::
|
|
|
130 * Installation::
|
|
|
131 * Omitting Files in Dired::
|
|
|
132 * Local Variables::
|
|
|
133 * Shell Command Guessing::
|
|
|
134 * Virtual Dired::
|
|
|
135 * Advanced Mark Commands::
|
|
|
136 * Multiple Dired Directories::
|
|
|
137 * Find File At Point::
|
|
|
138 * Miscellaneous Commands::
|
|
|
139 * Bugs::
|
|
|
140
|
|
49600
|
141 * Concept Index::
|
|
|
142 * Command Index::
|
|
|
143 * Key Index::
|
|
|
144 * Variable Index::
|
|
25829
|
145
|
|
|
146 @end menu
|
|
|
147
|
|
70801
|
148 @end ifnottex
|
|
25829
|
149
|
|
37994
|
150 @node Introduction, Installation, Top, Top
|
|
25829
|
151 @comment node-name, next, previous, up
|
|
|
152 @chapter Introduction
|
|
|
153
|
|
28669
|
154 This documents the @emph{extra} features for Dired Mode for GNU Emacs. It
|
|
|
155 is derived from version 1.191 of Sebastian Kremer's @file{dired-x.el}.
|
|
25829
|
156
|
|
|
157 In adopting this @file{dired-x.el} to GNU Emacs v19 some material that has
|
|
|
158 been incorporated into @file{dired.el} and @file{dired-aux.el} of the GNU Emacs
|
|
|
159 19 distribution has been removed and some material was modified for agreement
|
|
|
160 with the functions in @file{dired.el} and @file{dired-aux.el}. For example,
|
|
|
161 the code using @code{gmhist} history functions was replaced with code using
|
|
28669
|
162 the mini-buffer history now built into GNU Emacs. Finally, a few other
|
|
25829
|
163 features have been added and a few more functions have been bound to keys.
|
|
|
164
|
|
70801
|
165 @ifnottex
|
|
25829
|
166 @menu
|
|
|
167 * Features::
|
|
|
168 * Technical Details::
|
|
|
169 @end menu
|
|
70801
|
170 @end ifnottex
|
|
25829
|
171
|
|
37994
|
172 @node Features, Technical Details, , Introduction
|
|
25829
|
173 @comment node-name, next, previous, up
|
|
|
174 @section Features
|
|
|
175 @cindex Features
|
|
|
176
|
|
|
177 Some features provided by Dired Extra
|
|
|
178
|
|
|
179 @enumerate
|
|
|
180 @item
|
|
49600
|
181 Omitting uninteresting files from Dired listing.
|
|
25829
|
182 @itemize @bullet
|
|
26468
|
183 @xref{Omitting Files in Dired}.
|
|
25829
|
184 @end itemize
|
|
|
185 @item
|
|
36382
|
186 Local variables for Dired directories.
|
|
25829
|
187 @itemize @bullet
|
|
26468
|
188 @xref{Local Variables}.
|
|
25829
|
189 @end itemize
|
|
|
190 @item
|
|
36382
|
191 Guessing shell commands in Dired buffers.
|
|
25829
|
192 @itemize @bullet
|
|
26468
|
193 @xref{Shell Command Guessing}.
|
|
25829
|
194 @end itemize
|
|
|
195 @item
|
|
36382
|
196 Running Dired command in non-Dired buffers.
|
|
25829
|
197 @itemize @bullet
|
|
26468
|
198 @xref{Virtual Dired}.
|
|
25829
|
199 @end itemize
|
|
|
200 @item
|
|
|
201 Finding a file mentioned in a buffer
|
|
|
202 @itemize @bullet
|
|
26468
|
203 @xref{Find File At Point}.
|
|
25829
|
204 @end itemize
|
|
|
205 @item
|
|
|
206 Commands using file marking.
|
|
|
207 @itemize @bullet
|
|
26468
|
208 @xref{Advanced Mark Commands}.
|
|
25829
|
209 @end itemize
|
|
|
210 @end enumerate
|
|
|
211
|
|
|
212 @noindent
|
|
26468
|
213 @file{dired-x.el} binds some functions to keys in Dired Mode (@pxref{Key
|
|
25829
|
214 Index}) and also binds @kbd{C-x C-j} and @kbd{C-x 4 C-j} @emph{globally} to
|
|
26468
|
215 @code{dired-jump} (@pxref{Miscellaneous Commands}). It may also bind @kbd{C-x
|
|
25829
|
216 C-f} and @kbd{C-x 4 C-f} to @code{dired-x-find-file} and
|
|
26468
|
217 @code{dired-x-find-file-other-window}, respectively (@pxref{Find File At
|
|
25829
|
218 Point}).
|
|
|
219
|
|
37994
|
220 @node Technical Details, , Features, Introduction
|
|
25829
|
221 @comment node-name, next, previous, up
|
|
|
222 @section Technical Details
|
|
|
223 @cindex Redefined functions
|
|
|
224 @cindex @file{dired-aux.el}
|
|
|
225
|
|
|
226 When loaded this code @emph{redefines} the following functions of GNU Emacs
|
|
|
227 from @file{dired.el}
|
|
|
228
|
|
|
229 @itemize @bullet
|
|
|
230 @item
|
|
|
231 @code{dired-clean-up-after-deletion}
|
|
|
232 @item
|
|
|
233 @code{dired-find-buffer-nocreate}
|
|
|
234 @item
|
|
|
235 @code{dired-initial-position}
|
|
|
236 @item
|
|
|
237 @code{dired-up-directory}
|
|
|
238 @end itemize
|
|
|
239
|
|
|
240 @noindent
|
|
|
241 and the following functions from @file{dired-aux.el}
|
|
|
242
|
|
|
243 @itemize @bullet
|
|
|
244 @item
|
|
|
245 @code{dired-add-entry}
|
|
|
246 @item
|
|
|
247 @code{dired-read-shell-command}
|
|
|
248 @end itemize
|
|
|
249
|
|
37994
|
250 @node Installation, Omitting Files in Dired, Introduction, Top
|
|
25829
|
251 @comment node-name, next, previous, up
|
|
|
252 @chapter Installation
|
|
|
253
|
|
|
254 @noindent
|
|
36382
|
255 This manual describes the Dired features provided by the file
|
|
25829
|
256 @file{dired-x.el}. To take advantage of these features, you must load the
|
|
|
257 file and (optionally) set some variables.
|
|
|
258
|
|
|
259 @noindent
|
|
|
260 In your @file{.emacs} file in your home directory, or in the system-wide
|
|
|
261 initialization file @file{default.el} in the @file{site-lisp} directory, put
|
|
|
262
|
|
|
263 @example
|
|
|
264 (add-hook 'dired-load-hook
|
|
28344
|
265 (lambda ()
|
|
|
266 (load "dired-x")
|
|
|
267 ;; Set dired-x global variables here. For example:
|
|
|
268 ;; (setq dired-guess-shell-gnutar "gtar")
|
|
|
269 ;; (setq dired-x-hands-off-my-keys nil)
|
|
|
270 ))
|
|
25829
|
271 (add-hook 'dired-mode-hook
|
|
28344
|
272 (lambda ()
|
|
|
273 ;; Set dired-x buffer-local variables here. For example:
|
|
55928
|
274 ;; (dired-omit-mode 1)
|
|
28344
|
275 ))
|
|
25829
|
276 @end example
|
|
|
277
|
|
|
278 @noindent
|
|
36382
|
279 This will load @file{dired-x.el} when Dired is first invoked (for example,
|
|
|
280 when you first type @kbd{C-x d}).
|
|
25829
|
281
|
|
70801
|
282 @ifnottex
|
|
25829
|
283 @menu
|
|
|
284 * Optional Installation Dired Jump::
|
|
|
285 * Optional Installation File At Point::
|
|
|
286 @end menu
|
|
70801
|
287 @end ifnottex
|
|
25829
|
288
|
|
37994
|
289 @node Optional Installation Dired Jump, Optional Installation File At Point, , Installation
|
|
25829
|
290 @comment node-name, next, previous, up
|
|
|
291 @section Optional Installation Dired Jump
|
|
|
292
|
|
|
293 @cindex Autoloading @code{dired-jump} and @code{dired-jump-other-window}
|
|
|
294
|
|
|
295 In order to have @code{dired-jump} and @code{dired-jump-other-window}
|
|
26468
|
296 (@pxref{Miscellaneous Commands}) work @emph{before} @code{dired} and
|
|
25829
|
297 @code{dired-x} have been properly loaded the user should set-up an autoload
|
|
|
298 for these functions. In your @file{.emacs} file put
|
|
|
299
|
|
|
300 @example
|
71612
77266daa9ec9
Use ;; instead of ;;; to better follow coding conventions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
301 ;; Autoload `dired-jump' and `dired-jump-other-window'.
|
77266daa9ec9
Use ;; instead of ;;; to better follow coding conventions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
302 ;; We autoload from FILE dired.el. This will then load dired-x.el
|
77266daa9ec9
Use ;; instead of ;;; to better follow coding conventions.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
303 ;; and hence define `dired-jump' and `dired-jump-other-window'.
|
|
25829
|
304 (define-key global-map "\C-x\C-j" 'dired-jump)
|
|
|
305 (define-key global-map "\C-x4\C-j" 'dired-jump-other-window)
|
|
|
306
|
|
|
307 (autoload (quote dired-jump) "dired" "\
|
|
36382
|
308 Jump to Dired buffer corresponding to current buffer.
|
|
|
309 If in a file, Dired the current directory and move to file's line.
|
|
|
310 If in Dired already, pop up a level and goto old directory's line.
|
|
|
311 In case the proper Dired file line cannot be found, refresh the Dired
|
|
25829
|
312 buffer and try again." t nil)
|
|
|
313
|
|
|
314 (autoload (quote dired-jump-other-window) "dired" "\
|
|
|
315 Like \\[dired-jump] (dired-jump) but in other window." t nil)
|
|
|
316 @end example
|
|
|
317
|
|
|
318 Note that in recent releases of GNU Emacs 19 (i.e., 19.25 or later) the file
|
|
|
319 @file{../lisp/loaddefs.el} of the Emacs distribution already contains the
|
|
|
320 proper auto-loading for @code{dired-jump} so you need only put
|
|
|
321
|
|
|
322 @example
|
|
|
323 (define-key global-map "\C-x\C-j" 'dired-jump)
|
|
|
324 @end example
|
|
|
325
|
|
36382
|
326 @noindent
|
|
|
327 in your @file{.emacs} file in order to have @kbd{C-x C-j} work
|
|
25829
|
328 before @code{dired} is loaded.
|
|
|
329
|
|
28669
|
330 @node Optional Installation File At Point, , Optional Installation Dired Jump, Installation
|
|
25829
|
331 @comment node-name, next, previous, up
|
|
|
332 @section Optional Installation File At Point
|
|
|
333
|
|
|
334 @cindex Binding @code{dired-x-find-file}
|
|
|
335 If you choose to have @file{dired-x.el} bind @code{dired-x-find-file} over
|
|
26468
|
336 @code{find-file} (@pxref{Find File At Point}), then you will need to set
|
|
25829
|
337 @code{dired-x-hands-off-my-keys} and make a call to the function
|
|
|
338 @code{dired-x-bind-find-file} in the @code{dired-load-hook}:
|
|
|
339
|
|
|
340 @example
|
|
49600
|
341 (add-hook 'dired-load-hook
|
|
28344
|
342 (lambda ()
|
|
|
343 (load "dired-x")
|
|
|
344 ;; Bind dired-x-find-file.
|
|
|
345 (setq dired-x-hands-off-my-keys nil)
|
|
|
346 ;; Make sure our binding preference is invoked.
|
|
|
347 (dired-x-bind-find-file)
|
|
|
348 ))
|
|
25829
|
349 @end example
|
|
|
350
|
|
|
351 Alternatively, you can set the variable @emph{before} @file{dired-x.el} is
|
|
|
352 loaded
|
|
|
353
|
|
|
354 @example
|
|
49600
|
355 (add-hook 'dired-load-hook
|
|
28344
|
356 (lambda ()
|
|
|
357 ;; Bind dired-x-find-file.
|
|
|
358 (setq dired-x-hands-off-my-keys nil)
|
|
|
359 (load "dired-x")
|
|
|
360 ))
|
|
25829
|
361 @end example
|
|
|
362
|
|
37994
|
363 @node Omitting Files in Dired, Local Variables, Installation, Top
|
|
25829
|
364 @comment node-name, next, previous, up
|
|
|
365 @chapter Omitting Files in Dired
|
|
|
366
|
|
|
367 @cindex Omitting Files in Dired
|
|
36382
|
368 @cindex Uninteresting files
|
|
25829
|
369 @dfn{Omitting} a file means removing it from the directory listing. Omitting
|
|
|
370 is useful for keeping Dired buffers free of ``uninteresting'' files (for
|
|
|
371 instance, auto-save, auxiliary, backup, and revision control files) so that
|
|
|
372 the user can concentrate on the interesting files. Like hidden files, omitted
|
|
|
373 files are never seen by Dired. Omitting differs from hiding in several
|
|
|
374 respects:
|
|
|
375
|
|
|
376 @itemize @bullet
|
|
|
377
|
|
|
378 @item
|
|
|
379 Omitting works on individual files, not on directories; an entire directory
|
|
|
380 cannot be omitted (though each of its files could be).
|
|
|
381
|
|
|
382 @item
|
|
36382
|
383 Omitting is wholesale; if omitting is turned on for a Dired buffer, then all
|
|
25829
|
384 uninteresting files listed in that buffer are omitted. The user does not omit
|
|
|
385 (or unomit) files one at a time.
|
|
|
386
|
|
|
387 @item
|
|
|
388 Omitting can be automatic; uninteresting file lines in the buffer can be
|
|
|
389 removed before the user ever sees them.
|
|
|
390
|
|
|
391 @item
|
|
|
392 Marked files are never omitted.
|
|
|
393 @end itemize
|
|
|
394
|
|
|
395 @table @kbd
|
|
|
396 @item M-o
|
|
|
397 @kindex M-o
|
|
55928
|
398 @findex dired-omit-mode
|
|
|
399 (@code{dired-omit-mode}) Toggle between displaying and omitting
|
|
|
400 ``uninteresting'' files.
|
|
56061
|
401 @item * O
|
|
|
402 @kindex * O
|
|
55928
|
403 @findex dired-mark-omitted
|
|
|
404 (@code{dired-mark-omitted}) Mark ``uninteresting'' files.
|
|
25829
|
405 @end table
|
|
|
406
|
|
|
407 @noindent
|
|
|
408 In order to make Dired Omit work you first need to load @file{dired-x.el}
|
|
55928
|
409 inside @code{dired-load-hook} (@pxref{Installation}) and then evaluate
|
|
|
410 @code{(dired-omit-mode 1)} in some way (@pxref{Omitting Variables}).
|
|
25829
|
411
|
|
70801
|
412 @ifnottex
|
|
25829
|
413 @menu
|
|
|
414 * Omitting Variables::
|
|
|
415 * Omitting Examples::
|
|
|
416 * Omitting Technical::
|
|
|
417 @end menu
|
|
70801
|
418 @end ifnottex
|
|
25829
|
419
|
|
37994
|
420 @node Omitting Variables, Omitting Examples, , Omitting Files in Dired
|
|
25829
|
421 @comment node-name, next, previous, up
|
|
|
422
|
|
|
423 @section Omitting Variables
|
|
|
424
|
|
36382
|
425 @cindex Customizing file omitting
|
|
25829
|
426 The following variables can be used to customize omitting.
|
|
|
427
|
|
|
428 @table @code
|
|
|
429
|
|
55928
|
430 @vindex dired-omit-mode
|
|
|
431 @item dired-omit-mode
|
|
25829
|
432
|
|
|
433 Default: @code{nil}
|
|
|
434
|
|
|
435 @cindex How to make omitting the default in Dired
|
|
36382
|
436 If non-@code{nil}, ``uninteresting'' files are not listed.
|
|
|
437 Uninteresting files are those whose files whose names match regexp
|
|
|
438 @code{dired-omit-files}, plus those ending with extensions in
|
|
55928
|
439 @code{dired-omit-extensions}. @kbd{M-o} (@code{dired-omit-mode})
|
|
36382
|
440 toggles its value, which is buffer-local. Put
|
|
25829
|
441
|
|
|
442 @example
|
|
55928
|
443 (dired-omit-mode 1)
|
|
25829
|
444 @end example
|
|
|
445
|
|
36382
|
446 @noindent
|
|
25829
|
447 inside your @code{dired-mode-hook} to have omitting initially turned on in
|
|
26468
|
448 @emph{every} Dired buffer (@pxref{Installation}). You can then use @kbd{M-o} to
|
|
25829
|
449 unomit in that buffer.
|
|
|
450
|
|
|
451 To enable omitting automatically only in certain directories one can use Dired
|
|
|
452 Local Variables and put
|
|
|
453
|
|
|
454 @example
|
|
|
455 Local Variables:
|
|
55928
|
456 dired-omit-mode: t
|
|
25829
|
457 End:
|
|
|
458 @end example
|
|
|
459
|
|
|
460 @noindent
|
|
|
461 into a file @file{.dired} (the default value of
|
|
26468
|
462 @code{dired-local-variables-file}) in that directory (@pxref{Local Variables}).
|
|
25829
|
463
|
|
|
464 @table @code
|
|
|
465 @findex dired-omit-here-always
|
|
|
466 @item dired-omit-here-always
|
|
|
467
|
|
|
468 This is an interactive function that creates a local variables file exactly
|
|
|
469 like the example above (if it does not already exist) in the file
|
|
|
470 @code{dired-local-variables-file} in the current directory and then refreshes
|
|
26468
|
471 the directory listing (@pxref{Local Variables}).
|
|
25829
|
472 @end table
|
|
|
473
|
|
|
474 @vindex dired-omit-files
|
|
|
475 @item dired-omit-files
|
|
|
476
|
|
|
477 Default: @code{"^#\\|\\.$"}
|
|
|
478
|
|
36382
|
479 Files whose names match this buffer-local regexp will not be displayed.
|
|
55928
|
480 This only has effect when @code{dired-omit-mode}'s value is @code{t}.
|
|
25829
|
481
|
|
|
482 The default value omits the special directories @file{.} and @file{..} and
|
|
36382
|
483 autosave files (plus other files ending in @file{.}) (@pxref{Omitting Examples}).
|
|
25829
|
484
|
|
|
485 @vindex dired-omit-extensions
|
|
|
486 @item dired-omit-extensions
|
|
|
487
|
|
36382
|
488 Default: The elements of @code{completion-ignored-extensions},
|
|
25829
|
489 @code{dired-latex-unclean-extensions}, @code{dired-bibtex-unclean-extensions}
|
|
|
490 and @code{dired-texinfo-unclean-extensions}.
|
|
|
491
|
|
|
492 If non-@code{nil}, a list of extensions (strings) to omit from Dired listings.
|
|
|
493 Its format is the same as that of @code{completion-ignored-extensions}.
|
|
|
494
|
|
|
495 @vindex dired-omit-localp
|
|
|
496 @item dired-omit-localp
|
|
|
497
|
|
36382
|
498 Default: @code{no-dir}
|
|
25829
|
499
|
|
|
500 The @var{localp} argument @code{dired-omit-expunge} passes to
|
|
36382
|
501 @code{dired-get-filename}. If it is @code{no-dir}, omitting is much faster,
|
|
|
502 but you can only match against the non-directory part of the file name. Set it
|
|
|
503 to @code{nil} if you need to match the whole file name or @code{t} to match the
|
|
|
504 file name relative to the buffer's top-level directory.
|
|
25829
|
505
|
|
|
506 @item dired-omit-marker-char
|
|
|
507 @vindex dired-omit-marker-char
|
|
|
508 @cindex Omitting additional files
|
|
|
509 Default: @kbd{C-o}
|
|
|
510
|
|
36328
|
511 Temporary marker used by Dired to implement omitting. Should never be used
|
|
25829
|
512 as marker by the user or other packages. There is one exception to this rule:
|
|
36382
|
513 by adding
|
|
25829
|
514
|
|
|
515 @example
|
|
|
516 (setq dired-mark-keys "\C-o")
|
|
|
517 ;; i.e., the value of dired-omit-marker-char
|
|
|
518 ;; (which is not defined yet)
|
|
|
519 @end example
|
|
|
520
|
|
36382
|
521 @noindent
|
|
|
522 to your @file{~/.emacs}, you can bind the @kbd{C-o} key to insert a
|
|
25829
|
523 @kbd{C-o} marker, thus causing these files to be omitted in addition to the
|
|
|
524 usually omitted files. Unfortunately the files you omitted manually this way
|
|
|
525 will show up again after reverting the buffer, unlike the others.
|
|
|
526
|
|
|
527 @end table
|
|
|
528
|
|
|
529 @node Omitting Examples, Omitting Technical, Omitting Variables, Omitting Files in Dired
|
|
|
530 @comment node-name, next, previous, up
|
|
|
531 @section Examples of Omitting Various File Types
|
|
|
532
|
|
|
533 @itemize @bullet
|
|
|
534
|
|
|
535 @item
|
|
|
536 @cindex RCS files, how to omit them in Dired
|
|
|
537 @cindex Omitting RCS files in Dired
|
|
36382
|
538 If you wish to avoid seeing RCS files and the @file{RCS} directory, then put
|
|
25829
|
539
|
|
|
540 @example
|
|
|
541 (setq dired-omit-files
|
|
|
542 (concat dired-omit-files "\\|^RCS$\\|,v$"))
|
|
|
543 @end example
|
|
36382
|
544
|
|
25829
|
545 @noindent
|
|
26468
|
546 in the @code{dired-load-hook} (@pxref{Installation}). This assumes
|
|
36382
|
547 @code{dired-omit-localp} has its default value of @code{no-dir} to make the
|
|
25829
|
548 @code{^}-anchored matches work. As a slower alternative, with
|
|
|
549 @code{dired-omit-localp} set to @code{nil}, you can use @code{/} instead of
|
|
|
550 @code{^} in the regexp.
|
|
|
551
|
|
|
552 @item
|
|
|
553 @cindex Tib files, how to omit them in Dired
|
|
|
554 @cindex Omitting tib files in Dired
|
|
36382
|
555 If you use @code{tib}, the bibliography program for use with @TeX{} and
|
|
|
556 La@TeX{}, and you
|
|
|
557 want to omit the @file{INDEX} and the @file{*-t.tex} files, then put
|
|
25829
|
558
|
|
|
559 @example
|
|
|
560 (setq dired-omit-files
|
|
|
561 (concat dired-omit-files "\\|^INDEX$\\|-t\\.tex$"))
|
|
|
562 @end example
|
|
|
563
|
|
|
564 @noindent
|
|
26468
|
565 in the @code{dired-load-hook} (@pxref{Installation}).
|
|
25829
|
566
|
|
|
567 @item
|
|
|
568 @cindex Dot files, how to omit them in Dired
|
|
|
569 @cindex Omitting dot files in Dired
|
|
36382
|
570 If you do not wish to see @samp{dot} files (files starting with a @file{.}),
|
|
25829
|
571 then put
|
|
|
572
|
|
|
573 @example
|
|
|
574 (setq dired-omit-files
|
|
|
575 (concat dired-omit-files "\\|^\\..+$"))
|
|
|
576 @end example
|
|
|
577
|
|
|
578 @noindent
|
|
26468
|
579 in the @code{dired-load-hook} (@pxref{Installation}).
|
|
25829
|
580
|
|
|
581 @end itemize
|
|
|
582
|
|
37994
|
583 @node Omitting Technical, , Omitting Examples, Omitting Files in Dired
|
|
25829
|
584 @comment node-name, next, previous, up
|
|
|
585 @section Some Technical Details of Omitting
|
|
|
586
|
|
|
587 Loading @file{dired-x.el} will install Dired Omit by putting
|
|
|
588 @code{dired-omit-expunge} on your @code{dired-after-readin-hook}, and will
|
|
|
589 call @code{dired-extra-startup}, which in turn calls @code{dired-omit-startup}
|
|
|
590 in your @code{dired-mode-hook}.
|
|
|
591
|
|
37994
|
592 @node Local Variables, Shell Command Guessing, Omitting Files in Dired, Top
|
|
25829
|
593 @comment node-name, next, previous, up
|
|
|
594 @chapter Local Variables for Dired Directories
|
|
|
595
|
|
|
596 @cindex Local Variables for Dired Directories
|
|
|
597 @vindex dired-local-variables-file
|
|
|
598 @vindex dired-enable-local-variables
|
|
|
599 @noindent
|
|
|
600 When Dired visits a directory, it looks for a file whose name is the value of
|
|
|
601 variable @code{dired-local-variables-file} (default: @file{.dired}). If such
|
|
|
602 a file is found, Dired will temporarily insert it into the Dired buffer and
|
|
49600
|
603 run @code{hack-local-variables}.
|
|
25829
|
604
|
|
|
605 @noindent
|
|
|
606 For example, if the user puts
|
|
|
607
|
|
|
608 @example
|
|
|
609 Local Variables:
|
|
|
610 dired-actual-switches: "-lat"
|
|
55928
|
611 dired-omit-mode: t
|
|
25829
|
612 End:
|
|
|
613 @end example
|
|
|
614
|
|
|
615 @noindent
|
|
|
616 into a file called @file{.dired} in a directory then when that directory is
|
|
|
617 viewed it will be
|
|
|
618
|
|
|
619 @enumerate
|
|
|
620 @item
|
|
49600
|
621 sorted by date
|
|
25829
|
622 @item
|
|
|
623 omitted automatically
|
|
|
624 @end enumerate
|
|
|
625
|
|
|
626 @noindent
|
|
|
627 You can set @code{dired-local-variables-file} to @code{nil} to suppress this.
|
|
|
628 The value of @code{dired-enable-local-variables} controls if and how these
|
|
|
629 local variables are read. This variable exists so that if may override the
|
|
49600
|
630 default value of @code{enable-local-variables}.
|
|
25829
|
631
|
|
|
632 @noindent
|
|
|
633 Please see the GNU Emacs Manual to learn more about local variables.
|
|
|
634 @xref{File Variables,Local Variables in Files,Local Variables in
|
|
|
635 Files,emacs,The GNU Emacs Manual}.
|
|
|
636
|
|
|
637 @noindent
|
|
|
638 The following variables affect Dired Local Variables
|
|
|
639
|
|
|
640 @table @code
|
|
|
641 @vindex dired-local-variables-file
|
|
|
642 @item dired-local-variables-file
|
|
|
643 Default: @code{".dired"}
|
|
|
644
|
|
36382
|
645 If non-@code{nil}, file name for local variables for Dired. If Dired finds a
|
|
25829
|
646 file with that name in the current directory, it will temporarily insert it
|
|
36382
|
647 into the Dired buffer and run @code{hack-local-variables}.
|
|
25829
|
648
|
|
|
649 @vindex dired-enable-local-variables
|
|
|
650 @item dired-enable-local-variables
|
|
|
651 Default: @code{t}
|
|
|
652
|
|
36382
|
653 Controls the use of local-variables lists in Dired. The value can be @code{t},
|
|
25829
|
654 @code{nil}, or something else. A value of @code{t} means local-variables
|
|
|
655 lists are obeyed in the @code{dired-local-variables-file}; @code{nil} means
|
|
|
656 they are ignored; anything else means query. This variable temporarily
|
|
|
657 overrides the value of @code{enable-local-variables} when the Dired Local
|
|
|
658 Variables are hacked.
|
|
|
659 @end table
|
|
|
660
|
|
|
661 @node Shell Command Guessing, Virtual Dired, Local Variables, Top
|
|
|
662 @comment node-name, next, previous, up
|
|
|
663 @chapter Shell Command Guessing
|
|
|
664 @cindex Guessing shell commands for files.
|
|
|
665
|
|
36382
|
666 Based upon the name of a file, Dired tries to guess what shell
|
|
25829
|
667 command you might want to apply to it. For example, if you have point
|
|
|
668 on a file named @file{foo.tar} and you press @kbd{!}, Dired will guess
|
|
|
669 you want to @samp{tar xvf} it and suggest that as the default shell
|
|
|
670 command.
|
|
|
671
|
|
36382
|
672 The default is mentioned in brackets and you can type @kbd{M-p} to get
|
|
|
673 the default into the minibuffer and then edit it, e.g., to change
|
|
25829
|
674 @samp{tar xvf} to @samp{tar tvf}. If there are several commands for a given
|
|
|
675 file, e.g., @samp{xtex} and @samp{dvips} for a @file{.dvi} file, you can type
|
|
|
676 @kbd{M-p} several times to see each of the matching commands.
|
|
|
677
|
|
|
678 Dired only tries to guess a command for a single file, never for a list
|
|
|
679 of marked files.
|
|
|
680
|
|
|
681 @table @code
|
|
|
682 @item dired-guess-shell-alist-default
|
|
|
683 @vindex dired-guess-shell-alist-default
|
|
|
684 Predefined rules for shell commands. Set this to @code{nil} to turn guessing off.
|
|
|
685 The elements of @code{dired-guess-shell-alist-user} (defined by the
|
|
|
686 user) will override these rules.@refill
|
|
|
687
|
|
|
688 @item dired-guess-shell-alist-user
|
|
|
689 @vindex dired-guess-shell-alist-user
|
|
|
690 If non-@code{nil}, a user-defined alist of file regexps and their suggested
|
|
|
691 commands. These rules take precedence over the predefined rules in the
|
|
|
692 variable @code{dired-guess-shell-alist-default} (to which they are prepended)
|
|
|
693 when @code{dired-do-shell-command} is run).
|
|
|
694 @refill
|
|
|
695
|
|
|
696 Each element of the alist looks like
|
|
|
697
|
|
|
698 @example
|
|
|
699 (@var{regexp} @var{command}@dots{})
|
|
|
700 @end example
|
|
|
701
|
|
36382
|
702 @noindent
|
|
55201
|
703 where each @var{command} can either be a string or a Lisp expression
|
|
36382
|
704 that evaluates to a string. If several commands are given, all of
|
|
|
705 them will temporarily be pushed onto the history.
|
|
25829
|
706
|
|
52210
|
707 If @samp{*} in the shell command, that means to substitute the file
|
|
|
708 name.
|
|
|
709
|
|
25829
|
710 You can set this variable in your @file{~/.emacs}. For example,
|
|
|
711 to add rules for @samp{.foo} and @samp{.bar} file extensions, write
|
|
|
712
|
|
|
713 @example
|
|
|
714 (setq dired-guess-shell-alist-user
|
|
|
715 (list
|
|
|
716 (list "\\.foo$" "@var{foo-command}");; fixed rule
|
|
|
717 ;; possibly more rules...
|
|
|
718 (list "\\.bar$";; rule with condition test
|
|
|
719 '(if @var{condition}
|
|
|
720 "@var{bar-command-1}"
|
|
|
721 "@var{bar-command-2}"))))
|
|
|
722 @end example
|
|
|
723
|
|
|
724 @noindent
|
|
|
725 This will override any predefined rules for the same extensions.
|
|
|
726
|
|
|
727 @item dired-guess-shell-gnutar
|
|
|
728 @vindex dired-guess-shell-gnutar
|
|
36382
|
729 @cindex Passing GNU Tar its @samp{z} switch.
|
|
25829
|
730 Default: @code{nil}
|
|
|
731
|
|
36382
|
732 If non-@code{nil}, this is the name of the GNU Tar executable (e.g.,
|
|
|
733 @samp{tar} or @samp{gnutar}). GNU Tar's @samp{z} switch is used for
|
|
|
734 compressed tar files.
|
|
25829
|
735 If you don't have GNU tar, set this to @code{nil}: a pipe using @samp{zcat} is
|
|
|
736 then used.
|
|
|
737
|
|
|
738 @item dired-guess-shell-gzip-quiet
|
|
|
739 @vindex dired-guess-shell-gzip-quiet
|
|
36382
|
740 @cindex @code{gzip}
|
|
25829
|
741 Default: @code{t}
|
|
|
742
|
|
36382
|
743 A non-@code{nil} value means that @samp{-q} is passed to @code{gzip}
|
|
|
744 overriding a verbose option in the @env{GZIP} environment variable.
|
|
25829
|
745
|
|
|
746 @item dired-guess-shell-znew-switches nil
|
|
|
747 @vindex dired-guess-shell-znew-switches nil
|
|
36382
|
748 @cindex @code{znew}
|
|
25829
|
749 Default: @code{nil}
|
|
|
750
|
|
36382
|
751 A string of switches passed to @code{znew}. An example is
|
|
|
752 @samp{-K} which will make @code{znew} keep a @file{.Z} file when it is
|
|
|
753 smaller than the @file{.gz} file.
|
|
25829
|
754
|
|
|
755 @item dired-shell-command-history nil
|
|
|
756 @vindex dired-shell-command-history nil
|
|
|
757
|
|
|
758 History list for commands that read dired-shell commands.
|
|
|
759 @end table
|
|
|
760
|
|
|
761 @node Virtual Dired, Advanced Mark Commands, Shell Command Guessing, Top
|
|
|
762 @comment node-name, next, previous, up
|
|
|
763 @chapter Virtual Dired
|
|
|
764
|
|
|
765 @cindex Virtual Dired
|
|
36382
|
766 @cindex Perusing @code{ls} listings
|
|
|
767 @cindex @code{ls} listings, how to peruse them in Dired
|
|
25829
|
768 Using @dfn{Virtual Dired} means putting a buffer with Dired-like
|
|
|
769 contents in Dired mode. The files described by the buffer contents need
|
|
|
770 not actually exist. This is useful if you want to peruse an @samp{ls -lR}
|
|
|
771 output file, for example one you got from an FTP server. You can use
|
|
|
772 all motion commands usually available in Dired. You can also use
|
|
|
773 it to save a Dired buffer in a file and resume it in a later session.
|
|
|
774
|
|
|
775 @findex dired-virtual
|
|
|
776 @kindex g
|
|
|
777 @findex dired-virtual-revert
|
|
|
778 Type @kbd{M-x dired-virtual} to put the current buffer into virtual
|
|
|
779 Dired mode. You will be prompted for the top level directory of this
|
|
|
780 buffer, with a default value guessed from the buffer contents. To
|
|
|
781 convert the virtual to a real Dired buffer again, type @kbd{g} (which
|
|
|
782 calls @code{dired-virtual-revert}) in the virtual Dired buffer and
|
|
|
783 answer @samp{y}. You don't have to do this, though: you can relist
|
|
|
784 single subdirectories using @kbd{l} (@code{dired-do-redisplay}) on the subdirectory
|
|
|
785 headerline, leaving the buffer in virtual Dired mode all the time.
|
|
|
786
|
|
|
787 @findex dired-virtual-mode
|
|
|
788 @vindex auto-mode-alist
|
|
|
789 The function @samp{dired-virtual-mode} is specially designed to turn on
|
|
|
790 virtual Dired mode from the @code{auto-mode-alist}. To edit all
|
|
|
791 @file{*.dired} files automatically in virtual Dired mode, put this into your
|
|
|
792 @file{~/.emacs}:
|
|
|
793
|
|
|
794 @example
|
|
|
795 (setq auto-mode-alist (cons '("[^/]\\.dired$" . dired-virtual-mode)
|
|
|
796 auto-mode-alist))
|
|
|
797 @end example
|
|
|
798
|
|
36382
|
799 @noindent
|
|
|
800 The regexp is a bit more complicated than usual to exclude @file{.dired}
|
|
|
801 local-variable files.
|
|
25829
|
802
|
|
37994
|
803 @node Advanced Mark Commands, Multiple Dired Directories, Virtual Dired, Top
|
|
25829
|
804 @comment node-name, next, previous, up
|
|
|
805 @chapter Advanced Mark Commands
|
|
|
806
|
|
|
807 @table @kbd
|
|
|
808 @item F
|
|
|
809 @kindex F
|
|
|
810 @cindex Visiting several files at once
|
|
|
811 @cindex Simultaneous visiting of several files
|
|
|
812 @findex dired-do-find-marked-files
|
|
|
813 (@code{dired-do-find-marked-files}) Find all marked files at once displaying
|
|
36382
|
814 them simultaneously. If optional @var{noselect} is non-@code{nil} then just
|
|
|
815 find the
|
|
|
816 files but do not select. If you want to keep the Dired buffer displayed, type
|
|
25829
|
817 @kbd{C-x 2} first. If you want just the marked files displayed and nothing
|
|
|
818 else, type @kbd{C-x 1} first.
|
|
|
819
|
|
|
820 The current window is split across all files marked, as evenly as possible.
|
|
|
821 Remaining lines go to the bottom-most window. The number of files that can be
|
|
|
822 displayed this way is restricted by the height of the current window and the
|
|
|
823 variable @code{window-min-height}.
|
|
|
824 @end table
|
|
|
825
|
|
|
826 @table @code
|
|
|
827 @item dired-mark-extension
|
|
|
828 @findex dired-mark-extension
|
|
|
829 Mark all files with a certain extension for use in later commands. A @samp{.}
|
|
36382
|
830 is not automatically prepended to the string entered, you must type it
|
|
|
831 explicitly.
|
|
25829
|
832
|
|
36382
|
833 When called from Lisp, @var{extension} may also be a list of extensions
|
|
25829
|
834 and an optional argument @var{marker-char} specifies the marker used.
|
|
|
835
|
|
|
836 @item dired-flag-extension
|
|
|
837 @findex dired-flag-extension
|
|
|
838 Flag all files with a certain extension for deletion. A @samp{.} is
|
|
|
839 @emph{not} automatically prepended to the string entered.
|
|
|
840 @end table
|
|
|
841
|
|
70801
|
842 @ifnottex
|
|
25829
|
843 @menu
|
|
|
844 * Advanced Cleaning Functions::
|
|
|
845 * Advanced Cleaning Variables::
|
|
|
846 * Special Marking Function::
|
|
|
847 @end menu
|
|
70801
|
848 @end ifnottex
|
|
25829
|
849
|
|
37994
|
850 @node Advanced Cleaning Functions, Advanced Cleaning Variables, , Advanced Mark Commands
|
|
25829
|
851 @comment node-name, next, previous, up
|
|
|
852
|
|
|
853 @section Advanced Cleaning Functions
|
|
|
854
|
|
|
855 @table @code
|
|
|
856 @item dired-clean-patch
|
|
|
857 @findex dired-clean-patch
|
|
|
858 Flag dispensable files created by the @samp{patch} program for deletion. See
|
|
|
859 variable @code{dired-patch-unclean-extensions}.
|
|
|
860
|
|
|
861 @item dired-clean-tex
|
|
|
862 @findex dired-clean-tex
|
|
|
863 Flag dispensable files created by @TeX{}, La@TeX{}, and @samp{texinfo} for
|
|
26468
|
864 deletion. See the following variables (@pxref{Advanced Cleaning Variables}):
|
|
25829
|
865
|
|
|
866 @itemize @bullet
|
|
|
867 @item
|
|
|
868 @code{dired-tex-unclean-extensions}
|
|
|
869 @item
|
|
|
870 @code{dired-texinfo-unclean-extensions}
|
|
|
871 @item
|
|
|
872 @code{dired-latex-unclean-extensions}
|
|
|
873 @item
|
|
|
874 @code{dired-bibtex-unclean-extensions}
|
|
|
875 @end itemize
|
|
|
876
|
|
|
877 @item dired-very-clean-tex
|
|
|
878 @findex dired-very-clean-tex
|
|
36382
|
879 Flag dispensable files created by @TeX{}, La@TeX{}, @samp{texinfo},
|
|
|
880 and @file{*.dvi} files for deletion.
|
|
25829
|
881 @end table
|
|
|
882
|
|
|
883 @node Advanced Cleaning Variables, Special Marking Function, Advanced Cleaning Functions, Advanced Mark Commands
|
|
|
884 @comment node-name, next, previous, up
|
|
|
885
|
|
|
886 @section Advanced Cleaning Variables
|
|
|
887
|
|
|
888 @noindent Variables used by the above cleaning commands (and in the default value for
|
|
26468
|
889 variable @code{dired-omit-extensions}, @pxref{Omitting Variables})
|
|
25829
|
890
|
|
|
891 @table @code
|
|
|
892 @item dired-patch-unclean-extensions
|
|
|
893 @vindex dired-patch-unclean-extensions
|
|
36382
|
894 Default: @code{(".rej" ".orig")}
|
|
25829
|
895
|
|
|
896 List of extensions of dispensable files created by the @samp{patch} program.
|
|
|
897
|
|
|
898 @item dired-tex-unclean-extensions
|
|
|
899 @vindex dired-tex-unclean-extensions
|
|
36382
|
900 Default: @code{(".toc" ".log" ".aux")}
|
|
25829
|
901
|
|
|
902 List of extensions of dispensable files created by @TeX{}.
|
|
|
903
|
|
|
904 @item dired-texinfo-unclean-extensions
|
|
|
905 @vindex dired-texinfo-unclean-extensions
|
|
36382
|
906 Default: @code{(".cp" ".cps" ".fn" ".fns" ".ky" ".kys"}
|
|
25829
|
907 @code{".pg" ".pgs" ".tp" ".tps" ".vr" ".vrs")}
|
|
|
908
|
|
|
909 List of extensions of dispensable files created by @samp{texinfo}.
|
|
|
910
|
|
|
911 @item dired-latex-unclean-extensions
|
|
|
912 @vindex dired-latex-unclean-extensions
|
|
36382
|
913 Default: @code{(".idx" ".lof" ".lot" ".glo")}
|
|
25829
|
914
|
|
|
915 List of extensions of dispensable files created by La@TeX{}.
|
|
|
916
|
|
|
917 @item dired-bibtex-unclean-extensions
|
|
|
918 @vindex dired-bibtex-unclean-extensions
|
|
36382
|
919 Default: @code{(".blg" ".bbl")}
|
|
25829
|
920
|
|
|
921 List of extensions of dispensable files created by Bib@TeX{}.
|
|
|
922 @end table
|
|
|
923
|
|
37994
|
924 @node Special Marking Function, , Advanced Cleaning Variables, Advanced Mark Commands
|
|
25829
|
925 @comment node-name, next, previous, up
|
|
|
926
|
|
|
927 @section Special Marking Function
|
|
|
928
|
|
|
929 @table @kbd
|
|
|
930 @item M-(
|
|
|
931 @kindex M-(
|
|
|
932 @findex dired-mark-sexp
|
|
|
933 @cindex Lisp expression, marking files with in Dired
|
|
55201
|
934 @cindex Mark file by Lisp expression
|
|
25829
|
935 (@code{dired-mark-sexp}) Mark files for which @var{predicate} returns
|
|
|
936 non-@code{nil}. With a prefix argument, unflag those files instead.
|
|
|
937
|
|
55201
|
938 The @var{predicate} is a Lisp expression that can refer to the following
|
|
25829
|
939 symbols:
|
|
|
940 @table @code
|
|
|
941 @item inode
|
|
|
942 [@i{integer}] the inode of the file (only for @samp{ls -i} output)
|
|
|
943 @item s
|
|
|
944 [@i{integer}] the size of the file for @samp{ls -s} output (usually in blocks or,
|
|
|
945 with @samp{-k}, in KBytes)
|
|
|
946 @item mode
|
|
36382
|
947 [@i{string}] file permission bits, e.g., @samp{-rw-r--r--}
|
|
25829
|
948 @item nlink
|
|
|
949 [@i{integer}] number of links to file
|
|
|
950 @item uid
|
|
|
951 [@i{string}] owner
|
|
|
952 @item gid
|
|
|
953 [@i{string}] group (If the gid is not displayed by @samp{ls}, this
|
|
|
954 will still be set (to the same as uid))
|
|
|
955 @item size
|
|
|
956 [@i{integer}] file size in bytes
|
|
|
957 @item time
|
|
36382
|
958 [@i{string}] the time that @samp{ls} displays, e.g., @samp{Feb 12 14:17}
|
|
25829
|
959 @item name
|
|
|
960 [@i{string}] the name of the file
|
|
|
961 @item sym
|
|
36382
|
962 [@i{string}] if file is a symbolic link, the linked-to name, else @code{""}
|
|
25829
|
963 @end table
|
|
|
964
|
|
|
965 @noindent
|
|
|
966 For example, use
|
|
|
967 @example
|
|
|
968 (equal 0 size)
|
|
|
969 @end example
|
|
|
970 to mark all zero length files.
|
|
|
971
|
|
55201
|
972 To find out all not yet compiled Emacs Lisp files in a directory, Dired
|
|
25829
|
973 all @file{.el} files in the lisp directory using the wildcard
|
|
|
974 @samp{*.el}. Then use @kbd{M-(} with
|
|
|
975 @example
|
|
|
976 (not (file-exists-p (concat name "c")))
|
|
|
977 @end example
|
|
|
978 to mark all @file{.el} files without a corresponding @file{.elc} file.
|
|
|
979
|
|
|
980 @end table
|
|
|
981
|
|
37994
|
982 @node Multiple Dired Directories, Find File At Point, Advanced Mark Commands, Top
|
|
25829
|
983 @comment node-name, next, previous, up
|
|
|
984 @chapter Multiple Dired Directories and Non-Dired Commands
|
|
|
985
|
|
|
986 @cindex Multiple Dired directories
|
|
|
987 @cindex Working directory
|
|
|
988 An Emacs buffer can have but one working directory, stored in the
|
|
|
989 buffer-local variable @code{default-directory}. A Dired buffer may have
|
|
36382
|
990 several subdirectories inserted, but it still has only one working
|
|
|
991 directory: that of the top-level Dired directory in that buffer. For
|
|
25829
|
992 some commands it is appropriate that they use the current Dired
|
|
|
993 directory instead of @code{default-directory}, e.g., @code{find-file} and
|
|
|
994 @code{compile}.
|
|
|
995
|
|
|
996 A general mechanism is provided for special handling of the working
|
|
|
997 directory in special major modes:
|
|
|
998
|
|
|
999 @table @code
|
|
|
1000 @item default-directory-alist
|
|
|
1001 @vindex default-directory-alist
|
|
|
1002 Default: @code{((dired-mode . (dired-current-directory)))}
|
|
|
1003
|
|
36382
|
1004 Alist of major modes and their notion of @code{default-directory}, as a
|
|
55201
|
1005 Lisp expression to evaluate. A resulting value of @code{nil} is ignored
|
|
25829
|
1006 in favor of @code{default-directory}.
|
|
|
1007
|
|
60982
|
1008 @item dired-default-directory
|
|
|
1009 @findex dired-default-directory
|
|
|
1010 Use this function like you would use the variable
|
|
|
1011 @code{default-directory}, except that @code{dired-default-directory}
|
|
|
1012 also consults the variable @code{default-directory-alist}.
|
|
25829
|
1013 @end table
|
|
|
1014
|
|
|
1015 @node Find File At Point, Miscellaneous Commands, Multiple Dired Directories, Top
|
|
|
1016 @comment node-name, next, previous, up
|
|
|
1017
|
|
|
1018 @section Find File At Point
|
|
|
1019 @cindex Visiting a file mentioned in a buffer
|
|
|
1020 @cindex Finding a file at point
|
|
|
1021
|
|
|
1022 @file{dired-x} provides a method of visiting or editing a file mentioned in
|
|
36382
|
1023 the buffer you are viewing (e.g., a mail buffer, a news article, a
|
|
|
1024 @file{README} file, etc.) or to test if that file exists. You can then modify
|
|
|
1025 this in the minibuffer after snatching the file name.
|
|
25829
|
1026
|
|
|
1027 When installed @file{dired-x} will substitute @code{dired-x-find-file} for
|
|
|
1028 @code{find-file} (normally bound to @kbd{C-x C-f}) and
|
|
|
1029 @code{dired-x-find-file-other-window} for @code{find-file-other-window}
|
|
|
1030 (normally bound to @kbd{C-x 4 C-f}).
|
|
|
1031
|
|
|
1032 In order to use this feature, you will need to set
|
|
|
1033 @code{dired-x-hands-off-my-keys} to @code{nil} inside @code{dired-load-hook}
|
|
26468
|
1034 (@pxref{Optional Installation File At Point}).
|
|
25829
|
1035
|
|
|
1036 @table @code
|
|
|
1037 @item dired-x-find-file
|
|
|
1038 @findex dired-x-find-file
|
|
|
1039 @kindex C-x C-f
|
|
|
1040
|
|
|
1041 @code{dired-x-find-file} behaves exactly like @code{find-file} (normally bound
|
|
|
1042 to @kbd{C-x C-f}) unless a prefix argument is passed to the function in which
|
|
36382
|
1043 case it will use the file name at point as a guess for the file to visit.
|
|
25829
|
1044
|
|
|
1045 For example, if the buffer you were reading contained the words
|
|
|
1046
|
|
|
1047 @example
|
|
|
1048 Available via anonymous ftp in
|
|
|
1049
|
|
|
1050 /roebling.poly.edu:/pub/lisp/crypt++.el.gz
|
|
|
1051 @end example
|
|
|
1052
|
|
36382
|
1053 @noindent
|
|
25829
|
1054 then you could move your cursor to the line containing the ftp address and
|
|
|
1055 type @kbd{C-u C-x C-f} (the @kbd{C-u} is a universal argument). The
|
|
|
1056 minibuffer would read
|
|
|
1057
|
|
|
1058 @example
|
|
|
1059 Find file: /roebling.poly.edu:/pub/lisp/crypt++.el.gz
|
|
|
1060 @end example
|
|
|
1061
|
|
36382
|
1062 @noindent
|
|
|
1063 with the point after the last @code{/}. If you hit @key{RET}, emacs will visit
|
|
25829
|
1064 the file at that address. This also works with files on your own computer.
|
|
|
1065
|
|
|
1066 @item dired-x-find-file-other-window
|
|
|
1067 @findex dired-x-find-file-other-window
|
|
|
1068 @kindex C-x 4 C-f
|
|
|
1069
|
|
|
1070 @code{dired-x-find-file-other-window} behaves exactly like
|
|
|
1071 @code{find-file-other-window} (normally bound to @kbd{C-x 4 C-f}) unless a
|
|
|
1072 prefix argument is used. See @code{dired-x-find-file} for more information.
|
|
|
1073
|
|
|
1074 @item dired-x-hands-off-my-keys
|
|
|
1075 @vindex dired-x-hands-off-my-keys
|
|
|
1076 If set to @code{t}, then it means that @file{dired-x} should @emph{not} bind
|
|
|
1077 @code{dired-x-find-file} over @code{find-file} on keyboard. Similarly, it
|
|
|
1078 should not bind @code{dired-x-find-file-other-window} over
|
|
|
1079 @code{find-file-other-window}. If you change this variable after
|
|
|
1080 @file{dired-x.el} is loaded then do @kbd{M-x dired-x-bind-find-file}. The
|
|
36382
|
1081 default value of this variable is @code{t}; by default, the binding is not
|
|
25829
|
1082 done. See @xref{Optional Installation File At Point}.
|
|
|
1083
|
|
|
1084 @item dired-x-bind-find-file
|
|
|
1085 @findex dired-x-bind-find-file
|
|
|
1086 A function, which can be called interactively or in your @file{~/.emacs} file,
|
|
|
1087 that uses the value of @code{dired-x-hands-off-my-keys} to determine if
|
|
|
1088 @code{dired-x-find-file} should be bound over @code{find-file} and
|
|
|
1089 @code{dired-x-find-file-other-window} bound over
|
|
|
1090 @code{find-file-other-window}. See @xref{Optional Installation File At Point}.
|
|
|
1091 @end table
|
|
|
1092
|
|
|
1093 @node Miscellaneous Commands, Bugs, Find File At Point, Top
|
|
|
1094 @comment node-name, next, previous, up
|
|
|
1095 @chapter Miscellaneous Commands
|
|
|
1096
|
|
|
1097 Miscellaneous features not fitting anywhere else:
|
|
|
1098
|
|
|
1099 @table @code
|
|
|
1100 @item dired-find-subdir
|
|
|
1101 @vindex dired-find-subdir
|
|
|
1102 Default: @code{nil}
|
|
|
1103
|
|
|
1104 If non-@code{nil}, Dired does not make a new buffer for a directory if it can
|
|
|
1105 be found (perhaps as subdirectory) in some existing Dired buffer.
|
|
|
1106
|
|
|
1107 If there are several Dired buffers for a directory, the most recently
|
|
|
1108 used is chosen.
|
|
|
1109
|
|
|
1110 Dired avoids switching to the current buffer, so that if you have a
|
|
|
1111 normal and a wildcard buffer for the same directory, @kbd{C-x d RET}
|
|
|
1112 will toggle between those two.
|
|
|
1113 @end table
|
|
|
1114
|
|
|
1115 @table @kbd
|
|
|
1116 @findex dired-goto-subdir
|
|
|
1117 @kindex M-G
|
|
|
1118 @item M-G
|
|
36382
|
1119 (@code{dired-goto-subdir}) Go to the header line of an inserted directory.
|
|
|
1120 This command reads its argument, with completion derived from the names of the
|
|
25829
|
1121 inserted subdirectories.
|
|
|
1122 @end table
|
|
|
1123
|
|
|
1124 @table @code
|
|
|
1125 @item dired-smart-shell-command
|
|
|
1126 @findex dired-smart-shell-command
|
|
|
1127 @findex shell-command
|
|
|
1128 @kindex M-!
|
|
|
1129 Like function @code{shell-command}, but in the current Dired directory.
|
|
|
1130 Bound to @kbd{M-!} in Dired buffers.
|
|
|
1131
|
|
|
1132 @item dired-jump
|
|
|
1133 @findex dired-jump
|
|
|
1134 @kindex C-x C-j
|
|
36382
|
1135 @cindex Jumping to Dired listing containing file.
|
|
|
1136 Bound to @kbd{C-x C-j}. Jump back to Dired: If in a file, edit the current
|
|
25829
|
1137 directory and move to file's line. If in Dired already, pop up a level and
|
|
36382
|
1138 go to old directory's line. In case the proper Dired file line cannot be
|
|
25829
|
1139 found, refresh the Dired buffer and try again.
|
|
|
1140
|
|
|
1141 @item dired-jump-other-window
|
|
|
1142 @findex dired-jump-other-window
|
|
|
1143 @kindex C-x 4 C-j
|
|
|
1144 Bound to @kbd{C-x 4 C-j}. Like @code{dired-jump}, but to other window.
|
|
|
1145
|
|
|
1146 These functions can be autoloaded so they work even though @file{dired-x.el}
|
|
26468
|
1147 has not been loaded yet (@pxref{Optional Installation Dired Jump}).
|
|
25829
|
1148
|
|
|
1149 @vindex dired-bind-jump
|
|
|
1150 If the variable @code{dired-bind-jump} is @code{nil}, @code{dired-jump} will not be
|
|
|
1151 bound to @kbd{C-x C-j} and @code{dired-jump-other-window} will not be bound to
|
|
|
1152 @kbd{C-x 4 C-j}.
|
|
|
1153
|
|
|
1154 @item dired-vm
|
|
|
1155 @cindex Reading mail.
|
|
|
1156 @kindex V
|
|
|
1157 @findex dired-vm
|
|
63677
|
1158 Bound to @kbd{V} if @code{dired-bind-vm} is @code{t}. Run VM on this
|
|
|
1159 file (assumed to be a UNIX mail folder).
|
|
25829
|
1160
|
|
|
1161 @vindex dired-vm-read-only-folders
|
|
|
1162 If you give this command a prefix argument, it will visit the folder
|
|
36382
|
1163 read-only. This only works in VM 5, not VM 4.
|
|
25829
|
1164
|
|
36382
|
1165 If the variable @code{dired-vm-read-only-folders} is @code{t},
|
|
|
1166 @code{dired-vm} will
|
|
25829
|
1167 visit all folders read-only. If it is neither @code{nil} nor @code{t}, e.g.,
|
|
36382
|
1168 the symbol @code{if-file-read-only}, only files not writable by you are
|
|
25829
|
1169 visited read-only. This is the recommended value if you run VM 5.
|
|
|
1170
|
|
|
1171 @vindex dired-bind-vm
|
|
63677
|
1172 If the variable @code{dired-bind-vm} is @code{t}, @code{dired-vm} will be bound
|
|
|
1173 to @kbd{V}. Otherwise, @code{dired-bind-rmail} will be bound.
|
|
25829
|
1174
|
|
|
1175 @item dired-rmail
|
|
|
1176 @cindex Reading mail.
|
|
|
1177 @findex dired-rmail
|
|
|
1178 Bound to @kbd{V} if @code{dired-bind-vm} is @code{nil}. Run Rmail on this
|
|
|
1179 file (assumed to be mail folder in Rmail/BABYL format).
|
|
|
1180
|
|
|
1181 @item dired-info
|
|
|
1182 @kindex I
|
|
|
1183 @cindex Running info.
|
|
|
1184 @findex dired-info
|
|
|
1185 Bound to @kbd{I}. Run Info on this file (assumed to be a file in Info
|
|
|
1186 format).
|
|
|
1187
|
|
|
1188 @vindex dired-bind-info
|
|
|
1189 If the variable @code{dired-bind-info} is @code{nil}, @code{dired-info} will
|
|
36382
|
1190 not be bound to @kbd{I}.
|
|
25829
|
1191
|
|
|
1192 @item dired-man
|
|
|
1193 @cindex Running man.
|
|
|
1194 @kindex N
|
|
|
1195 @findex dired-man
|
|
36382
|
1196 Bound to @kbd{N}. Run man on this file (assumed to be a file in @code{nroff}
|
|
25829
|
1197 format).
|
|
|
1198
|
|
|
1199 @vindex dired-bind-man
|
|
|
1200 If the variable @code{dired-bind-man} is @code{nil}, @code{dired-man} will not
|
|
36382
|
1201 be bound to @kbd{N}.
|
|
25829
|
1202
|
66337
14837742f3d8
(Miscellaneous Commands): Replace dired-do-relative-symlink by dired-do-relsymlink
Lars Hansen <larsh@soem.dk>
diff
changeset
|
1203 @item dired-do-relsymlink
|
|
25829
|
1204 @cindex Relative symbolic links.
|
|
|
1205 @kindex Y
|
66337
14837742f3d8
(Miscellaneous Commands): Replace dired-do-relative-symlink by dired-do-relsymlink
Lars Hansen <larsh@soem.dk>
diff
changeset
|
1206 @findex dired-do-relsymlink
|
|
25829
|
1207 Bound to @kbd{Y}. Relative symlink all marked (or next ARG) files into a
|
|
|
1208 directory, or make a relative symbolic link to the current file. This creates
|
|
|
1209 relative symbolic links like
|
|
|
1210
|
|
36382
|
1211 @example
|
|
25829
|
1212 foo -> ../bar/foo
|
|
36382
|
1213 @end example
|
|
25829
|
1214
|
|
36382
|
1215 @noindent
|
|
25829
|
1216 not absolute ones like
|
|
|
1217
|
|
36382
|
1218 @example
|
|
25829
|
1219 foo -> /ugly/path/that/may/change/any/day/bar/foo
|
|
36382
|
1220 @end example
|
|
25829
|
1221
|
66337
14837742f3d8
(Miscellaneous Commands): Replace dired-do-relative-symlink by dired-do-relsymlink
Lars Hansen <larsh@soem.dk>
diff
changeset
|
1222 @item dired-do-relsymlink-regexp
|
|
25829
|
1223 @kindex %Y
|
66337
14837742f3d8
(Miscellaneous Commands): Replace dired-do-relative-symlink by dired-do-relsymlink
Lars Hansen <larsh@soem.dk>
diff
changeset
|
1224 @findex dired-do-relsymlink-regexp
|
|
36382
|
1225 Bound to @kbd{%Y}. Relative symlink all marked files containing
|
|
|
1226 @var{regexp} to @var{newname}. See functions
|
|
|
1227 @code{dired-do-rename-regexp} and @code{dired-do-relsymlink} for more
|
|
|
1228 info.
|
|
25829
|
1229 @end table
|
|
|
1230
|
|
|
1231 @node Bugs, Concept Index, Miscellaneous Commands, Top
|
|
|
1232 @comment node-name, next, previous, up
|
|
|
1233 @chapter Bugs
|
|
|
1234 @cindex Bugs
|
|
|
1235 @findex dired-x-submit-report
|
|
|
1236
|
|
|
1237 @noindent
|
|
|
1238 If you encounter a bug in this package, wish to suggest an
|
|
|
1239 enhancement, or want to make a smart remark, then type
|
|
|
1240
|
|
|
1241 @example
|
|
49600
|
1242 @kbd{M-x dired-x-submit-report}
|
|
25829
|
1243 @end example
|
|
|
1244
|
|
|
1245 @noindent
|
|
|
1246 to set up an outgoing mail buffer, with the proper address to the
|
|
|
1247 @file{dired-x.el} maintainer automatically inserted in the @samp{To:@:} field.
|
|
|
1248 This command also inserts information that the Dired X maintainer can use to
|
|
|
1249 recreate your exact setup, making it easier to verify your bug or social
|
|
|
1250 maladjustment.
|
|
|
1251
|
|
49600
|
1252 Lawrence R. Dodd
|
|
28669
|
1253 @c <dodd@@roebling.poly.edu>
|
|
25829
|
1254
|
|
|
1255 @node Concept Index, Command Index, Bugs, Top
|
|
|
1256 @comment node-name, next, previous, up
|
|
|
1257 @unnumbered Concept Index
|
|
|
1258 @printindex cp
|
|
|
1259
|
|
|
1260 @node Command Index, Key Index, Concept Index, Top
|
|
|
1261 @comment node-name, next, previous, up
|
|
|
1262 @unnumbered Function Index
|
|
|
1263 @printindex fn
|
|
|
1264
|
|
|
1265 @node Key Index, Variable Index, Command Index, Top
|
|
|
1266 @comment node-name, next, previous, up
|
|
|
1267 @unnumbered Key Index
|
|
|
1268 @printindex ky
|
|
|
1269
|
|
28669
|
1270 @node Variable Index, , Key Index, Top
|
|
25829
|
1271 @comment node-name, next, previous, up
|
|
|
1272 @unnumbered Variable Index
|
|
|
1273 @printindex vr
|
|
|
1274
|
|
29713
|
1275 @setchapternewpage odd
|
|
25829
|
1276 @c @summarycontents
|
|
|
1277 @contents
|
|
|
1278
|
|
|
1279 @bye
|
|
|
1280 @c dired-x.texi ends here.
|
|
52401
|
1281
|
|
|
1282 @ignore
|
|
|
1283 arch-tag: 201727aa-9318-4c74-a0d7-4f51c550c4de
|
|
|
1284 @end ignore
|
