annotate doc/misc/dired-x.texi @ 112428:5653bdbb0b32

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