annotate man/dired-x.texi @ 37042:a644f4966169

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