Mercurial > emacs
annotate man/dired-x.texi @ 74405:8289a04178f1
*** empty log message ***
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Mon, 04 Dec 2006 12:26:35 +0000 |
parents | 77266daa9ec9 |
children | 3d45362f1d38 138ce2701550 |
rev | line source |
---|---|
25829 | 1 \input texinfo @comment -*-texinfo-*- |
2 | |
3 @c dired-x.texi --- Sebastian Kremer's Extra DIRED hacked up for GNU Emacs19 | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
8 @c Version: 2.53 |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
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
3723093a21fd
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
63677
diff
changeset
|
31 Copyright @copyright{} 1993, 1994, 2001, 2002, 2003, 2004, |
69681
11b616eddda4
@copyright{}, no indentation in @copying{}
Karl Berry <karl@gnu.org>
parents:
68639
diff
changeset
|
32 2005, 2006 Free Software Foundation, Inc. |
25829 | 33 |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
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
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
60 @end quotation |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
61 @end copying |
25829 | 62 |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
63 @dircategory Emacs |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
64 @direntry |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
65 * Dired-X: (dired-x). Dired Extra Features. |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
66 @end direntry |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
67 |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
68 @c @smallbook |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
69 @tex |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
70 \overfullrule=0pt |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
71 %\global\baselineskip 30pt % For printing in double spaces |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
72 @end tex |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
83 @center Manual Revision: 2.53 |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
92 @insertcopying |
25829 | 93 @end titlepage |
94 | |
95 @page | |
96 | |
70801 | 97 @ifnottex |
25829 | 98 |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
37994
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
112 @item |
25829 | 113 For @file{dired-x.el} revision 2 |
114 | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
115 @c @item |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
141 * Concept Index:: |
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
142 * Command Index:: |
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
143 * Key Index:: |
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
144 * Variable Index:: |
25829 | 145 |
146 @end menu | |
147 | |
70801 | 148 @end ifnottex |
25829 | 149 |
37994
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
186 Local variables for Dired directories. |
25829 | 187 @itemize @bullet |
26468 | 188 @xref{Local Variables}. |
25829 | 189 @end itemize |
190 @item | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
191 Guessing shell commands in Dired buffers. |
25829 | 192 @itemize @bullet |
26468 | 193 @xref{Shell Command Guessing}. |
25829 | 194 @end itemize |
195 @item | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
250 @node Installation, Omitting Files in Dired, Introduction, Top |
25829 | 251 @comment node-name, next, previous, up |
252 @chapter Installation | |
253 | |
254 @noindent | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
265 (lambda () |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
266 (load "dired-x") |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
267 ;; Set dired-x global variables here. For example: |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
268 ;; (setq dired-guess-shell-gnutar "gtar") |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
269 ;; (setq dired-x-hands-off-my-keys nil) |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
270 )) |
25829 | 271 (add-hook 'dired-mode-hook |
28344
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
272 (lambda () |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
273 ;; Set dired-x buffer-local variables here. For example: |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
274 ;; (dired-omit-mode 1) |
28344
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
275 )) |
25829 | 276 @end example |
277 | |
278 @noindent | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
279 This will load @file{dired-x.el} when Dired is first invoked (for example, |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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>
parents:
70801
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>
parents:
70801
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>
parents:
70801
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
308 Jump to Dired buffer corresponding to current buffer. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
309 If in a file, Dired the current directory and move to file's line. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
310 If in Dired already, pop up a level and goto old directory's line. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
326 @noindent |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
341 (add-hook 'dired-load-hook |
28344
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
342 (lambda () |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
343 (load "dired-x") |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
344 ;; Bind dired-x-find-file. |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
345 (setq dired-x-hands-off-my-keys nil) |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
346 ;; Make sure our binding preference is invoked. |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
347 (dired-x-bind-find-file) |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
355 (add-hook 'dired-load-hook |
28344
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
356 (lambda () |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
357 ;; Bind dired-x-find-file. |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
358 (setq dired-x-hands-off-my-keys nil) |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
359 (load "dired-x") |
54fda0e8528a
Weed out redundant uses of `function'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26468
diff
changeset
|
360 )) |
25829 | 361 @end example |
362 | |
37994
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
398 @findex dired-omit-mode |
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
399 (@code{dired-omit-mode}) Toggle between displaying and omitting |
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
400 ``uninteresting'' files. |
56061
7bfa7f4ece46
(dired-mark-omitted): Update keybinding.
Lars Hansen <larsh@soem.dk>
parents:
55928
diff
changeset
|
401 @item * O |
7bfa7f4ece46
(dired-mark-omitted): Update keybinding.
Lars Hansen <larsh@soem.dk>
parents:
55928
diff
changeset
|
402 @kindex * O |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
403 @findex dired-mark-omitted |
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
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
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
409 inside @code{dired-load-hook} (@pxref{Installation}) and then evaluate |
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
425 @cindex Customizing file omitting |
25829 | 426 The following variables can be used to customize omitting. |
427 | |
428 @table @code | |
429 | |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
430 @vindex dired-omit-mode |
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
431 @item dired-omit-mode |
25829 | 432 |
433 Default: @code{nil} | |
434 | |
435 @cindex How to make omitting the default in Dired | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
436 If non-@code{nil}, ``uninteresting'' files are not listed. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
437 Uninteresting files are those whose files whose names match regexp |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
438 @code{dired-omit-files}, plus those ending with extensions in |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
439 @code{dired-omit-extensions}. @kbd{M-o} (@code{dired-omit-mode}) |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
440 toggles its value, which is buffer-local. Put |
25829 | 441 |
442 @example | |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
443 (dired-omit-mode 1) |
25829 | 444 @end example |
445 | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
479 Files whose names match this buffer-local regexp will not be displayed. |
55928
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
498 Default: @code{no-dir} |
25829 | 499 |
500 The @var{localp} argument @code{dired-omit-expunge} passes to | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
501 @code{dired-get-filename}. If it is @code{no-dir}, omitting is much faster, |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
502 but you can only match against the non-directory part of the file name. Set it |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
503 to @code{nil} if you need to match the whole file name or @code{t} to match the |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
80404bf7aafe
(Omitting Variables): Remove doubled word.
Gerd Moellmann <gerd@gnu.org>
parents:
30009
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
521 @noindent |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
544 |
25829 | 545 @noindent |
26468 | 546 in the @code{dired-load-hook} (@pxref{Installation}). This assumes |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
555 If you use @code{tib}, the bibliography program for use with @TeX{} and |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
556 La@TeX{}, and you |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
257777d5b005
(variable dired-omit-mode): Rename from dired-omit-files-p.
Lars Hansen <larsh@soem.dk>
parents:
55201
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
672 The default is mentioned in brackets and you can type @kbd{M-p} to get |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
702 @noindent |
55201 | 703 where each @var{command} can either be a string or a Lisp expression |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
704 that evaluates to a string. If several commands are given, all of |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
705 them will temporarily be pushed onto the history. |
25829 | 706 |
52210
eb055edafe69
(Shell Command Guessing): Explain *.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
707 If @samp{*} in the shell command, that means to substitute the file |
eb055edafe69
(Shell Command Guessing): Explain *.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
708 name. |
eb055edafe69
(Shell Command Guessing): Explain *.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
729 @cindex Passing GNU Tar its @samp{z} switch. |
25829 | 730 Default: @code{nil} |
731 | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
732 If non-@code{nil}, this is the name of the GNU Tar executable (e.g., |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
733 @samp{tar} or @samp{gnutar}). GNU Tar's @samp{z} switch is used for |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
740 @cindex @code{gzip} |
25829 | 741 Default: @code{t} |
742 | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
743 A non-@code{nil} value means that @samp{-q} is passed to @code{gzip} |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
748 @cindex @code{znew} |
25829 | 749 Default: @code{nil} |
750 | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
751 A string of switches passed to @code{znew}. An example is |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
752 @samp{-K} which will make @code{znew} keep a @file{.Z} file when it is |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
766 @cindex Perusing @code{ls} listings |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
799 @noindent |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
800 The regexp is a bit more complicated than usual to exclude @file{.dired} |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
801 local-variable files. |
25829 | 802 |
37994
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
814 them simultaneously. If optional @var{noselect} is non-@code{nil} then just |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
815 find the |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
830 is not automatically prepended to the string entered, you must type it |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
831 explicitly. |
25829 | 832 |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
879 Flag dispensable files created by @TeX{}, La@TeX{}, @samp{texinfo}, |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
919 Default: @code{(".blg" ".bbl")} |
25829 | 920 |
921 List of extensions of dispensable files created by Bib@TeX{}. | |
922 @end table | |
923 | |
37994
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
04649657763c
Fix Next and Prev pointers in @node directives, so
Eli Zaretskii <eliz@gnu.org>
parents:
36382
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
990 several subdirectories inserted, but it still has only one working |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
26f327ef246e
(Multiple Dired Directories): default-directory was renamed
Eli Zaretskii <eliz@gnu.org>
parents:
56061
diff
changeset
|
1008 @item dired-default-directory |
26f327ef246e
(Multiple Dired Directories): default-directory was renamed
Eli Zaretskii <eliz@gnu.org>
parents:
56061
diff
changeset
|
1009 @findex dired-default-directory |
26f327ef246e
(Multiple Dired Directories): default-directory was renamed
Eli Zaretskii <eliz@gnu.org>
parents:
56061
diff
changeset
|
1010 Use this function like you would use the variable |
26f327ef246e
(Multiple Dired Directories): default-directory was renamed
Eli Zaretskii <eliz@gnu.org>
parents:
56061
diff
changeset
|
1011 @code{default-directory}, except that @code{dired-default-directory} |
26f327ef246e
(Multiple Dired Directories): default-directory was renamed
Eli Zaretskii <eliz@gnu.org>
parents:
56061
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1023 the buffer you are viewing (e.g., a mail buffer, a news article, a |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1024 @file{README} file, etc.) or to test if that file exists. You can then modify |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1062 @noindent |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1119 (@code{dired-goto-subdir}) Go to the header line of an inserted directory. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1135 @cindex Jumping to Dired listing containing file. |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
0f1e07e44d2d
(Miscellaneous Commands): Texinfo usage fix.
Juanma Barranquero <lekktu@gmail.com>
parents:
60982
diff
changeset
|
1158 Bound to @kbd{V} if @code{dired-bind-vm} is @code{t}. Run VM on this |
0f1e07e44d2d
(Miscellaneous Commands): Texinfo usage fix.
Juanma Barranquero <lekktu@gmail.com>
parents:
60982
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1163 read-only. This only works in VM 5, not VM 4. |
25829 | 1164 |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1165 If the variable @code{dired-vm-read-only-folders} is @code{t}, |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1166 @code{dired-vm} will |
25829 | 1167 visit all folders read-only. If it is neither @code{nil} nor @code{t}, e.g., |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
0f1e07e44d2d
(Miscellaneous Commands): Texinfo usage fix.
Juanma Barranquero <lekktu@gmail.com>
parents:
60982
diff
changeset
|
1172 If the variable @code{dired-bind-vm} is @code{t}, @code{dired-vm} will be bound |
0f1e07e44d2d
(Miscellaneous Commands): Texinfo usage fix.
Juanma Barranquero <lekktu@gmail.com>
parents:
60982
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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>
parents:
64890
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>
parents:
64890
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
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1211 @example |
25829 | 1212 foo -> ../bar/foo |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1213 @end example |
25829 | 1214 |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1215 @noindent |
25829 | 1216 not absolute ones like |
1217 | |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1218 @example |
25829 | 1219 foo -> /ugly/path/that/may/change/any/day/bar/foo |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1220 @end example |
25829 | 1221 |
66337
14837742f3d8
(Miscellaneous Commands): Replace dired-do-relative-symlink by dired-do-relsymlink
Lars Hansen <larsh@soem.dk>
parents:
64890
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>
parents:
64890
diff
changeset
|
1224 @findex dired-do-relsymlink-regexp |
36382
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1225 Bound to @kbd{%Y}. Relative symlink all marked files containing |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1226 @var{regexp} to @var{newname}. See functions |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
1227 @code{dired-do-rename-regexp} and @code{dired-do-relsymlink} for more |
5ecd29c2f552
Lots of markup and wording changes.
Eli Zaretskii <eliz@gnu.org>
parents:
36328
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47737
diff
changeset
|
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 |