* term/vt100.el (vt100-wide-mode): Fix :init-value keyword (bug#6620).
[bpt/emacs.git] / lisp / dired.el
CommitLineData
c8472948 1;;; dired.el --- directory-browsing commands
52041219 2
87ae59e3 3;; Copyright (C) 1985, 1986, 1992, 1993, 1994, 1995, 1996, 1997, 2000,
114f9c96 4;; 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
f143d380 5;; Free Software Foundation, Inc.
ab67260b 6
b36b40ae
RS
7;; Author: Sebastian Kremer <sk@thp.uni-koeln.de>
8;; Maintainer: FSF
565132a3 9;; Keywords: files
84fc2cfa
ER
10
11;; This file is part of GNU Emacs.
12
eb3fa2cf 13;; GNU Emacs is free software: you can redistribute it and/or modify
84fc2cfa 14;; it under the terms of the GNU General Public License as published by
eb3fa2cf
GM
15;; the Free Software Foundation, either version 3 of the License, or
16;; (at your option) any later version.
84fc2cfa
ER
17
18;; GNU Emacs is distributed in the hope that it will be useful,
19;; but WITHOUT ANY WARRANTY; without even the implied warranty of
20;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21;; GNU General Public License for more details.
22
23;; You should have received a copy of the GNU General Public License
eb3fa2cf 24;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
84fc2cfa 25
52041219
RS
26;;; Commentary:
27
e41b2db1
ER
28;; This is a major mode for directory browsing and editing. It is
29;; documented in the Emacs manual.
30
492d2437
RS
31;; Rewritten in 1990/1991 to add tree features, file marking and
32;; sorting by Sebastian Kremer <sk@thp.uni-koeln.de>.
33;; Finished up by rms in 1992.
34
52041219 35;;; Code:
492d2437 36
2f0adb0b
SM
37(eval-when-compile (require 'cl))
38
492d2437
RS
39;;; Customizable variables
40
286c247d
RS
41(defgroup dired nil
42 "Directory editing."
d7aed37c 43 :link '(custom-manual "(emacs)Dired")
ca66efd1 44 :group 'files)
286c247d
RS
45
46(defgroup dired-mark nil
68d2f12f 47 "Handling marks in Dired."
286c247d
RS
48 :prefix "dired-"
49 :group 'dired)
50
51
84fc2cfa 52;;;###autoload
6bdad9ae 53(defcustom dired-listing-switches (purecopy "-al")
9201cc28 54 "Switches passed to `ls' for Dired. MUST contain the `l' option.
492d2437 55May contain all other options that don't contradict `-l';
b36b40ae 56may contain even `F', `b', `i' and `s'. See also the variable
48404d5a
EZ
57`dired-ls-F-marks-symlinks' concerning the `F' switch.
58On systems such as MS-DOS and MS-Windows, which use `ls' emulation in Lisp,
59some of the `ls' switches are not supported; see the doc string of
a6d231bb 60`insert-directory' in `ls-lisp.el' for more details."
286c247d
RS
61 :type 'string
62 :group 'dired)
84fc2cfa 63
5553077c
LT
64(defvar dired-subdir-switches nil
65 "If non-nil, switches passed to `ls' for inserting subdirectories.
66If nil, `dired-listing-switches' is used.")
67
470fa6d1 68; Don't use absolute file names as /bin should be in any PATH and people
492d2437
RS
69; may prefer /usr/local/gnu/bin or whatever. However, chown is
70; usually not in PATH.
71
72;;;###autoload
84fc2cfa 73(defvar dired-chown-program
6bdad9ae 74 (purecopy
f3041af1 75 (if (memq system-type '(hpux usg-unix-v irix linux gnu/linux cygwin))
6702f50d
RS
76 "chown"
77 (if (file-exists-p "/usr/sbin/chown")
78 "/usr/sbin/chown"
6bdad9ae 79 "/etc/chown")))
eb8c3be9 80 "Name of chown command (usually `chown' or `/etc/chown').")
492d2437 81
0b7bc76f
RS
82(defvar dired-use-ls-dired (not (not (string-match "gnu" system-configuration)))
83 "Non-nil means Dired should use `ls --dired'.")
84
912aace8
GV
85(defvar dired-chmod-program "chmod"
86 "Name of chmod command (usually `chmod').")
723ddb1f 87
57654b8c
JL
88(defvar dired-touch-program "touch"
89 "Name of touch command (usually `touch').")
90
286c247d 91(defcustom dired-ls-F-marks-symlinks nil
9201cc28 92 "Informs Dired about how `ls -lF' marks symbolic links.
fc83abf7
RS
93Set this to t if `ls' (or whatever program is specified by
94`insert-directory-program') with `-lF' marks the symbolic link
492d2437 95itself with a trailing @ (usually the case under Ultrix).
84fc2cfa 96
492d2437
RS
97Example: if `ln -s foo bar; ls -F bar' gives `bar -> foo', set it to
98nil (the default), if it gives `bar@ -> foo', set it to t.
99
100Dired checks if there is really a @ appended. Thus, if you have a
101marking `ls' program on one host and a non-marking on another host, and
102don't care about symbolic links which really end in a @, you can
286c247d
RS
103always set this variable to t."
104 :type 'boolean
105 :group 'dired-mark)
492d2437
RS
106
107;;;###autoload
aaa448c9 108(defcustom dired-trivial-filenames (purecopy "^\\.\\.?$\\|^#")
9201cc28 109 "Regexp of files to skip when finding first file of a directory.
492d2437 110A value of nil means move to the subdir line.
286c247d
RS
111A value of t means move to first file."
112 :type '(choice (const :tag "Move to subdir" nil)
113 (const :tag "Move to first" t)
114 regexp)
115 :group 'dired)
492d2437 116
286c247d 117(defcustom dired-keep-marker-rename t
492d2437 118 ;; Use t as default so that moved files "take their markers with them".
9201cc28 119 "Controls marking of renamed files.
492d2437
RS
120If t, files keep their previous marks when they are renamed.
121If a character, renamed files (whether previously marked or not)
286c247d
RS
122are afterward marked with that character."
123 :type '(choice (const :tag "Keep" t)
124 (character :tag "Mark"))
125 :group 'dired-mark)
492d2437 126
286c247d 127(defcustom dired-keep-marker-copy ?C
9201cc28 128 "Controls marking of copied files.
492d2437 129If t, copied files are marked if and as the corresponding original files were.
286c247d
RS
130If a character, copied files are unconditionally marked with that character."
131 :type '(choice (const :tag "Keep" t)
132 (character :tag "Mark"))
133 :group 'dired-mark)
492d2437 134
286c247d 135(defcustom dired-keep-marker-hardlink ?H
9201cc28 136 "Controls marking of newly made hard links.
492d2437 137If t, they are marked if and as the files linked to were marked.
286c247d
RS
138If a character, new links are unconditionally marked with that character."
139 :type '(choice (const :tag "Keep" t)
140 (character :tag "Mark"))
141 :group 'dired-mark)
492d2437 142
286c247d 143(defcustom dired-keep-marker-symlink ?Y
9201cc28 144 "Controls marking of newly made symbolic links.
492d2437 145If t, they are marked if and as the files linked to were marked.
286c247d
RS
146If a character, new links are unconditionally marked with that character."
147 :type '(choice (const :tag "Keep" t)
148 (character :tag "Mark"))
149 :group 'dired-mark)
492d2437 150
286c247d 151(defcustom dired-dwim-target nil
9201cc28 152 "If non-nil, Dired tries to guess a default target directory.
492d2437
RS
153This means: if there is a dired buffer displayed in the next window,
154use its current subdir, instead of the current subdir of this dired buffer.
155
286c247d
RS
156The target is used in the prompt for file copy, rename etc."
157 :type 'boolean
158 :group 'dired)
492d2437 159
286c247d 160(defcustom dired-copy-preserve-time t
9201cc28 161 "If non-nil, Dired preserves the last-modified time in a file copy.
286c247d
RS
162\(This works on only some systems.)"
163 :type 'boolean
164 :group 'dired)
492d2437 165
05b855f5
EZ
166; These variables were deleted and the replacements are on files.el.
167; We leave aliases behind for back-compatibility.
168(defvaralias 'dired-free-space-program 'directory-free-space-program)
169(defvaralias 'dired-free-space-args 'directory-free-space-args)
170
492d2437
RS
171;;; Hook variables
172
c2792945 173(defcustom dired-load-hook nil
ee680b2b 174 "Run after loading Dired.
c2792945
EZ
175You can customize key bindings or load extensions with this."
176 :group 'dired
177 :type 'hook)
492d2437 178
c2792945 179(defcustom dired-mode-hook nil
ee680b2b 180 "Run at the very end of `dired-mode'."
c2792945
EZ
181 :group 'dired
182 :type 'hook)
492d2437 183
c2792945
EZ
184(defcustom dired-before-readin-hook nil
185 "This hook is run before a dired buffer is read in (created or reverted)."
186 :group 'dired
187 :type 'hook)
492d2437 188
c2792945 189(defcustom dired-after-readin-hook nil
492d2437
RS
190 "Hook run after each time a file or directory is read by Dired.
191After each listing of a file or directory, this hook is run
c2792945
EZ
192with the buffer narrowed to the listing."
193 :group 'dired
194 :type 'hook)
492d2437
RS
195;; Note this can't simply be run inside function `dired-ls' as the hook
196;; functions probably depend on the dired-subdir-alist to be OK.
197
1ed8284d
RS
198(defcustom dired-dnd-protocol-alist
199 '(("^file:///" . dired-dnd-handle-local-file)
200 ("^file://" . dired-dnd-handle-file)
201 ("^file:" . dired-dnd-handle-local-file))
202 "The functions to call when a drop in `dired-mode' is made.
203See `dnd-protocol-alist' for more information. When nil, behave
3db7bf54 204as in other buffers. Changing this option is effective only for
f7a8a965 205new dired buffers."
1ed8284d
RS
206 :type '(choice (repeat (cons (regexp) (function)))
207 (const :tag "Behave as in other buffers" nil))
208 :version "22.1"
209 :group 'dired)
210
2b2059d8 211;; Internal variables
492d2437
RS
212
213(defvar dired-marker-char ?* ; the answer is 42
214 ;; so that you can write things like
215 ;; (let ((dired-marker-char ?X))
216 ;; ;; great code using X markers ...
217 ;; )
218 ;; For example, commands operating on two sets of files, A and B.
219 ;; Or marking files with digits 0-9. This could implicate
220 ;; concentric sets or an order for the marked files.
221 ;; The code depends on dynamic scoping on the marker char.
222 "In Dired, the current mark character.
884b7f9d 223This is what the do-commands look for, and what the mark-commands store.")
492d2437
RS
224
225(defvar dired-del-marker ?D
226 "Character used to flag files for deletion.")
227
ee680b2b 228(defvar dired-shrink-to-fit t
ab67260b
RS
229;; I see no reason ever to make this nil -- rms.
230;; (> baud-rate search-slow-speed)
492d2437
RS
231 "Non-nil means Dired shrinks the display buffer to fit the marked files.")
232
233(defvar dired-flagging-regexp nil);; Last regexp used to flag files.
234
ab67260b
RS
235(defvar dired-file-version-alist)
236
e956c609 237;;;###autoload
492d2437 238(defvar dired-directory nil
ee680b2b 239 "The directory name or wildcard spec that this dired directory lists.
8d23c16b 240Local to each dired buffer. May be a list, in which case the car is the
0b7bc76f
RS
241directory name and the cdr is the list of files to mention.
242The directory name must be absolute, but need not be fully expanded.")
492d2437
RS
243
244(defvar dired-actual-switches nil
245 "The value of `dired-listing-switches' used to make this buffer's text.")
246
247(defvar dired-re-inode-size "[0-9 \t]*"
248 "Regexp for optional initial inode and file size as made by `ls -i -s'.")
249
250;; These regexps must be tested at beginning-of-line, but are also
251;; used to search for next matches, so neither omitting "^" nor
252;; replacing "^" by "\n" (to make it slightly faster) will work.
253
254(defvar dired-re-mark "^[^ \n]")
255;; "Regexp matching a marked line.
256;; Important: the match ends just after the marker."
257(defvar dired-re-maybe-mark "^. ")
312a9e03
EZ
258;; The [^:] part after "d" and "l" is to avoid confusion with the
259;; DOS/Windows-style drive letters in directory names, like in "d:/foo".
260(defvar dired-re-dir (concat dired-re-maybe-mark dired-re-inode-size "d[^:]"))
261(defvar dired-re-sym (concat dired-re-maybe-mark dired-re-inode-size "l[^:]"))
492d2437
RS
262(defvar dired-re-exe;; match ls permission string of an executable file
263 (mapconcat (function
264 (lambda (x)
265 (concat dired-re-maybe-mark dired-re-inode-size x)))
266 '("-[-r][-w][xs][-r][-w].[-r][-w]."
267 "-[-r][-w].[-r][-w][xs][-r][-w]."
268 "-[-r][-w].[-r][-w].[-r][-w][xst]")
269 "\\|"))
e6cecd2b 270(defvar dired-re-perms "[-bcdlps][-r][-w].[-r][-w].[-r][-w].")
147e214c 271(defvar dired-re-dot "^.* \\.\\.?/?$")
492d2437 272
5553077c 273;; The subdirectory names in the next two lists are expanded.
492d2437
RS
274(defvar dired-subdir-alist nil
275 "Association list of subdirectories and their buffer positions.
276Each subdirectory has an element: (DIRNAME . STARTMARKER).
7b2469ae
RS
277The order of elements is the reverse of the order in the buffer.
278In simple cases, this list contains one element.")
492d2437 279
5553077c
LT
280(defvar dired-switches-alist nil
281 "Keeps track of which switches to use for inserted subdirectories.
282This is an alist of the form (SUBDIR . SWITCHES).")
283(make-variable-buffer-local 'dired-switches-alist)
284
5afea280
RS
285(defvaralias 'dired-move-to-filename-regexp
286 'directory-listing-before-filename-regexp)
287
cdf156a9 288(defvar dired-subdir-regexp "^. \\([^\n\r]+\\)\\(:\\)[\n\r]"
492d2437
RS
289 "Regexp matching a maybe hidden subdirectory line in `ls -lR' output.
290Subexpression 1 is the subdirectory proper, no trailing colon.
291The match starts at the beginning of the line and ends after the end
292of the line (\\n or \\r).
293Subexpression 2 must end right before the \\n or \\r.")
294
0b0e6651 295(defgroup dired-faces nil
ee680b2b 296 "Faces used by Dired."
0b0e6651
JL
297 :group 'dired
298 :group 'faces)
299
300(defface dired-header
301 '((t (:inherit font-lock-type-face)))
302 "Face used for directory headers."
303 :group 'dired-faces
bf247b6e 304 :version "22.1")
0b0e6651
JL
305(defvar dired-header-face 'dired-header
306 "Face name used for directory headers.")
307
308(defface dired-mark
309 '((t (:inherit font-lock-constant-face)))
310 "Face used for dired marks."
311 :group 'dired-faces
bf247b6e 312 :version "22.1")
0b0e6651
JL
313(defvar dired-mark-face 'dired-mark
314 "Face name used for dired marks.")
315
316(defface dired-marked
317 '((t (:inherit font-lock-warning-face)))
318 "Face used for marked files."
319 :group 'dired-faces
bf247b6e 320 :version "22.1")
0b0e6651
JL
321(defvar dired-marked-face 'dired-marked
322 "Face name used for marked files.")
323
324(defface dired-flagged
325 '((t (:inherit font-lock-warning-face)))
326 "Face used for flagged files."
327 :group 'dired-faces
bf247b6e 328 :version "22.1")
0b0e6651
JL
329(defvar dired-flagged-face 'dired-flagged
330 "Face name used for flagged files.")
331
332(defface dired-warning
0f0c86fc
MR
333 ;; Inherit from font-lock-warning-face since with min-colors 8
334 ;; font-lock-comment-face is not colored any more.
335 '((t (:inherit font-lock-warning-face)))
0b0e6651
JL
336 "Face used to highlight a part of a buffer that needs user attention."
337 :group 'dired-faces
bf247b6e 338 :version "22.1")
0b0e6651
JL
339(defvar dired-warning-face 'dired-warning
340 "Face name used for a part of a buffer that needs user attention.")
341
0199e765 342(defface dired-perm-write
38838c80 343 '((((type w32 pc)) :inherit default) ;; These default to rw-rw-rw.
e1dab605
JL
344 ;; Inherit from font-lock-comment-delimiter-face since with min-colors 8
345 ;; font-lock-comment-face is not colored any more.
0199e765 346 (t (:inherit font-lock-comment-delimiter-face)))
38838c80
EZ
347 "Face used to highlight permissions of group- and world-writable files."
348 :group 'dired-faces
349 :version "22.2")
0199e765 350(defvar dired-perm-write-face 'dired-perm-write
38838c80
EZ
351 "Face name used for permissions of group- and world-writable files.")
352
0b0e6651
JL
353(defface dired-directory
354 '((t (:inherit font-lock-function-name-face)))
355 "Face used for subdirectories."
356 :group 'dired-faces
bf247b6e 357 :version "22.1")
0b0e6651
JL
358(defvar dired-directory-face 'dired-directory
359 "Face name used for subdirectories.")
360
361(defface dired-symlink
362 '((t (:inherit font-lock-keyword-face)))
363 "Face used for symbolic links."
364 :group 'dired-faces
bf247b6e 365 :version "22.1")
0b0e6651
JL
366(defvar dired-symlink-face 'dired-symlink
367 "Face name used for symbolic links.")
368
369(defface dired-ignored
cf78a467 370 '((t (:inherit shadow)))
0b0e6651
JL
371 "Face used for files suffixed with `completion-ignored-extensions'."
372 :group 'dired-faces
bf247b6e 373 :version "22.1")
0b0e6651
JL
374(defvar dired-ignored-face 'dired-ignored
375 "Face name used for files suffixed with `completion-ignored-extensions'.")
376
2439570d
SM
377(defvar dired-font-lock-keywords
378 (list
0b0e6651
JL
379 ;;
380 ;; Dired marks.
381 (list dired-re-mark '(0 dired-mark-face))
2439570d
SM
382 ;;
383 ;; We make heavy use of MATCH-ANCHORED, since the regexps don't identify the
384 ;; file name itself. We search for Dired defined regexps, and then use the
385 ;; Dired defined function `dired-move-to-filename' before searching for the
386 ;; simple regexp ".+". It is that regexp which matches the file name.
387 ;;
0b0e6651
JL
388 ;; Marked files.
389 (list (concat "^[" (char-to-string dired-marker-char) "]")
390 '(".+" (dired-move-to-filename) nil (0 dired-marked-face)))
391 ;;
392 ;; Flagged files.
393 (list (concat "^[" (char-to-string dired-del-marker) "]")
394 '(".+" (dired-move-to-filename) nil (0 dired-flagged-face)))
4fdf389a
RS
395 ;; People who are paranoid about security would consider this more
396 ;; important than other things such as whether it is a directory.
397 ;; But we don't want to encourage paranoia, so our default
398 ;; should be what's most useful for non-paranoids. -- rms.
399;;; ;;
400;;; ;; Files that are group or world writable.
401;;; (list (concat dired-re-maybe-mark dired-re-inode-size
402;;; "\\([-d]\\(....w....\\|.......w.\\)\\)")
0b0e6651
JL
403;;; '(1 dired-warning-face)
404;;; '(".+" (dired-move-to-filename) nil (0 dired-warning-face)))
d7aed37c
SM
405 ;; However, we don't need to highlight the file name, only the
406 ;; permissions, to win generally. -- fx.
407 ;; Fixme: we could also put text properties on the permission
408 ;; fields with keymaps to frob the permissions, somewhat a la XEmacs.
409 (list (concat dired-re-maybe-mark dired-re-inode-size
f16bcc9a 410 "[-d]....\\(w\\)....") ; group writable
0199e765 411 '(1 dired-perm-write-face))
d7aed37c 412 (list (concat dired-re-maybe-mark dired-re-inode-size
f16bcc9a 413 "[-d].......\\(w\\).") ; world writable
0199e765 414 '(1 dired-perm-write-face))
2439570d
SM
415 ;;
416 ;; Subdirectories.
417 (list dired-re-dir
0b0e6651 418 '(".+" (dired-move-to-filename) nil (0 dired-directory-face)))
2439570d
SM
419 ;;
420 ;; Symbolic links.
c60ee5e7 421 (list dired-re-sym
0b0e6651 422 '(".+" (dired-move-to-filename) nil (0 dired-symlink-face)))
2439570d
SM
423 ;;
424 ;; Files suffixed with `completion-ignored-extensions'.
425 '(eval .
2b2059d8
SM
426 ;; It is quicker to first find just an extension, then go back to the
427 ;; start of that file name. So we do this complex MATCH-ANCHORED form.
428 (list (concat "\\(" (regexp-opt completion-ignored-extensions) "\\|#\\)$")
2225a196
RS
429 '(".+" (dired-move-to-filename) nil (0 dired-ignored-face))))
430 ;;
431 ;; Files suffixed with `completion-ignored-extensions'
432 ;; plus a character put in by -F.
433 '(eval .
434 (list (concat "\\(" (regexp-opt completion-ignored-extensions)
435 "\\|#\\)[*=|]$")
436 '(".+" (progn
437 (end-of-line)
438 ;; If the last character is not part of the filename,
439 ;; move back to the start of the filename
440 ;; so it can be fontified.
441 ;; Otherwise, leave point at the end of the line;
442 ;; that way, nothing is fontified.
443 (unless (get-text-property (1- (point)) 'mouse-face)
444 (dired-move-to-filename)))
445 nil (0 dired-ignored-face))))
a5dad58a
AS
446 ;;
447 ;; Explicitly put the default face on file names ending in a colon to
448 ;; avoid fontifying them as directory header.
449 (list (concat dired-re-maybe-mark dired-re-inode-size dired-re-perms ".*:$")
fc7da30b 450 '(".+" (dired-move-to-filename) nil (0 'default)))
a5dad58a
AS
451 ;;
452 ;; Directory headers.
453 (list dired-subdir-regexp '(1 dired-header-face))
2225a196 454)
2439570d 455 "Additional expressions to highlight in Dired mode.")
65536d1d
RS
456
457(defvar dnd-protocol-alist)
83fadedf 458\f
492d2437
RS
459;;; Macros must be defined before they are used, for the byte compiler.
460
492d2437 461(defmacro dired-mark-if (predicate msg)
d7aed37c
SM
462 "Mark all files for which PREDICATE evals to non-nil.
463PREDICATE is evaluated on each line, with point at beginning of line.
464MSG is a noun phrase for the type of files being marked.
465It should end with a noun that can be pluralized by adding `s'.
466Return value is the number of files marked, or nil if none were marked."
f836b98e 467 `(let ((inhibit-read-only t) count)
8a946354
SS
468 (save-excursion
469 (setq count 0)
470 (if ,msg (message "Marking %ss..." ,msg))
471 (goto-char (point-min))
472 (while (not (eobp))
473 (if ,predicate
474 (progn
475 (delete-char 1)
476 (insert dired-marker-char)
477 (setq count (1+ count))))
478 (forward-line 1))
479 (if ,msg (message "%s %s%s %s%s."
480 count
481 ,msg
482 (dired-plural-s count)
483 (if (eq dired-marker-char ?\040) "un" "")
484 (if (eq dired-marker-char dired-del-marker)
485 "flagged" "marked"))))
486 (and (> count 0) count)))
492d2437 487
09b092ad
RS
488(defmacro dired-map-over-marks (body arg &optional show-progress
489 distinguish-one-marked)
91947235
SM
490 "Eval BODY with point on each marked line. Return a list of BODY's results.
491If no marked file could be found, execute BODY on the current line.
7ada496c
CY
492ARG, if non-nil, specifies the files to use instead of the marked files.
493 If ARG is an integer, use the next ARG (or previous -ARG, if
494 ARG<0) files. In that case, point is dragged along. This is
495 so that commands on the next ARG (instead of the marked) files
496 can be chained easily.
497 For any other non-nil value of ARG, use the current file.
91947235
SM
498If optional third arg SHOW-PROGRESS evaluates to non-nil,
499 redisplay the dired buffer after each file is processed.
500No guarantee is made about the position on the marked line.
501 BODY must ensure this itself if it depends on this.
502Search starts at the beginning of the buffer, thus the car of the list
503 corresponds to the line nearest to the buffer's bottom. This
504 is also true for (positive and negative) integer values of ARG.
09b092ad
RS
505BODY should not be too long as it is expanded four times.
506
507If DISTINGUISH-ONE-MARKED is non-nil, then if we find just one marked file,
508return (t FILENAME) instead of (FILENAME)."
91947235
SM
509 ;;
510 ;;Warning: BODY must not add new lines before point - this may cause an
511 ;;endless loop.
512 ;;This warning should not apply any longer, sk 2-Sep-1991 14:10.
513 `(prog1
f836b98e 514 (let ((inhibit-read-only t) case-fold-search found results)
91947235
SM
515 (if ,arg
516 (if (integerp ,arg)
517 (progn ;; no save-excursion, want to move point.
518 (dired-repeat-over-lines
519 ,arg
520 (function (lambda ()
521 (if ,show-progress (sit-for 0))
522 (setq results (cons ,body results)))))
523 (if (< ,arg 0)
524 (nreverse results)
525 results))
526 ;; non-nil, non-integer ARG means use current file:
527 (list ,body))
528 (let ((regexp (dired-marker-regexp)) next-position)
529 (save-excursion
530 (goto-char (point-min))
531 ;; remember position of next marked file before BODY
532 ;; can insert lines before the just found file,
533 ;; confusing us by finding the same marked file again
534 ;; and again and...
535 (setq next-position (and (re-search-forward regexp nil t)
536 (point-marker))
537 found (not (null next-position)))
538 (while next-position
539 (goto-char next-position)
540 (if ,show-progress (sit-for 0))
541 (setq results (cons ,body results))
542 ;; move after last match
543 (goto-char next-position)
544 (forward-line 1)
545 (set-marker next-position nil)
492d2437 546 (setq next-position (and (re-search-forward regexp nil t)
91947235 547 (point-marker)))))
09b092ad
RS
548 (if (and ,distinguish-one-marked (= (length results) 1))
549 (setq results (cons t results)))
91947235
SM
550 (if found
551 results
552 (list ,body)))))
553 ;; save-excursion loses, again
554 (dired-move-to-filename)))
492d2437 555
09b092ad 556(defun dired-get-marked-files (&optional localp arg filter distinguish-one-marked)
492d2437
RS
557 "Return the marked files' names as list of strings.
558The list is in the same order as the buffer, that is, the car is the
559 first marked file.
1312bfc6 560Values returned are normally absolute file names.
492d2437 561Optional arg LOCALP as in `dired-get-filename'.
7ada496c
CY
562Optional second argument ARG, if non-nil, specifies files near
563 point instead of marked files. It usually comes from the prefix
564 argument.
565 If ARG is an integer, use the next ARG files.
566 Any other non-nil value means to use the current file instead.
1312bfc6 567Optional third argument FILTER, if non-nil, is a function to select
09b092ad
RS
568 some of the files--those for which (funcall FILTER FILENAME) is non-nil.
569
570If DISTINGUISH-ONE-MARKED is non-nil, then if we find just one marked file,
571return (t FILENAME) instead of (FILENAME).
572Don't use that together with FILTER."
573 (let* ((all-of-them
574 (save-excursion
575 (dired-map-over-marks
576 (dired-get-filename localp)
577 arg nil distinguish-one-marked)))
578 result)
1312bfc6 579 (if (not filter)
09b092ad
RS
580 (if (and distinguish-one-marked (eq (car all-of-them) t))
581 all-of-them
582 (nreverse all-of-them))
1312bfc6
RS
583 (dolist (file all-of-them)
584 (if (funcall filter file)
585 (push file result)))
586 result)))
83fadedf 587\f
492d2437
RS
588;; The dired command
589
590(defun dired-read-dir-and-switches (str)
591 ;; For use in interactive.
6f6c43ff
CY
592 (reverse (list
593 (if current-prefix-arg
594 (read-string "Dired listing switches: "
595 dired-listing-switches))
596 ;; If a dialog is about to be used, call read-directory-name so
597 ;; the dialog code knows we want directories. Some dialogs can
598 ;; only select directories or files when popped up, not both.
599 (if (next-read-file-uses-dialog-p)
600 (read-directory-name (format "Dired %s(directory): " str)
601 nil default-directory nil)
7d371eac
JL
602 (read-file-name (format "Dired %s(directory): " str)
603 nil default-directory nil)))))
6f6c43ff
CY
604
605;; We want to switch to a more sophisticated version of
606;; dired-read-dir-and-switches like the following, if there is a way
607;; to make it more intuitive. See bug#1285.
608
609;; (defun dired-read-dir-and-switches (str)
610;; ;; For use in interactive.
611;; (reverse
612;; (list
613;; (if current-prefix-arg
614;; (read-string "Dired listing switches: "
615;; dired-listing-switches))
616;; ;; If a dialog is about to be used, call read-directory-name so
617;; ;; the dialog code knows we want directories. Some dialogs can
618;; ;; only select directories or files when popped up, not both.
619;; (if (next-read-file-uses-dialog-p)
620;; (read-directory-name (format "Dired %s(directory): " str)
621;; nil default-directory nil)
622;; (let ((cie ()))
623;; (dolist (ext completion-ignored-extensions)
624;; (if (eq ?/ (aref ext (1- (length ext)))) (push ext cie)))
625;; (setq cie (concat (regexp-opt cie "\\(?:") "\\'"))
626;; (lexical-let* ((default (and buffer-file-name
627;; (abbreviate-file-name buffer-file-name)))
628;; (cie cie)
629;; (completion-table
630;; ;; We need a mix of read-file-name and
631;; ;; read-directory-name so that completion to directories
632;; ;; is preferred, but if the user wants to enter a global
633;; ;; pattern, he can still use completion on filenames to
634;; ;; help him write the pattern.
635;; ;; Essentially, we want to use
636;; ;; (completion-table-with-predicate
637;; ;; 'read-file-name-internal 'file-directory-p nil)
638;; ;; but that doesn't work because read-file-name-internal
639;; ;; does not obey its `predicate' argument.
640;; (completion-table-in-turn
641;; (lambda (str pred action)
642;; (let ((read-file-name-predicate
643;; (lambda (f)
644;; (and (not (member f '("./" "../")))
645;; ;; Hack! Faster than file-directory-p!
646;; (eq (aref f (1- (length f))) ?/)
647;; (not (string-match cie f))))))
648;; (complete-with-action
649;; action 'read-file-name-internal str nil)))
650;; 'read-file-name-internal)))
651;; (minibuffer-with-setup-hook
652;; (lambda ()
653;; (setq minibuffer-default default)
654;; (setq minibuffer-completion-table completion-table))
655;; (read-file-name (format "Dired %s(directory): " str)
656;; nil default-directory nil))))))))
84fc2cfa 657
7d371eac
JL
658(defun dired-file-name-at-point ()
659 "Try to get a file name at point in the current dired buffer.
660This hook is inteneded to be put in `file-name-at-point-functions'."
661 (let ((filename (dired-get-filename nil t)))
662 (when filename
663 (if (file-directory-p filename)
664 (file-name-as-directory (abbreviate-file-name filename))
665 (abbreviate-file-name filename)))))
666
492d2437 667;;;###autoload (define-key ctl-x-map "d" 'dired)
84fc2cfa 668;;;###autoload
492d2437 669(defun dired (dirname &optional switches)
84fc2cfa 670 "\"Edit\" directory DIRNAME--delete, rename, print, etc. some files in it.
492d2437
RS
671Optional second argument SWITCHES specifies the `ls' options used.
672\(Interactively, use a prefix argument to be able to specify SWITCHES.)
673Dired displays a list of files in DIRNAME (which may also have
8d23c16b 674shell wildcards appended to select certain files). If DIRNAME is a cons,
1015daba 675its first element is taken as the directory name and the rest as an explicit
8d23c16b 676list of files to make directory entries for.
52041219 677\\<dired-mode-map>\
492d2437 678You can move around in it with the usual commands.
8d23c16b
ER
679You can flag files for deletion with \\[dired-flag-file-deletion] and then
680delete them by typing \\[dired-do-flagged-delete].
ee680b2b 681Type \\[describe-mode] after entering Dired for more info.
84fc2cfa 682
492d2437
RS
683If DIRNAME is already in a dired buffer, that buffer is used without refresh."
684 ;; Cannot use (interactive "D") because of wildcards.
685 (interactive (dired-read-dir-and-switches ""))
686 (switch-to-buffer (dired-noselect dirname switches)))
687
688;;;###autoload (define-key ctl-x-4-map "d" 'dired-other-window)
84fc2cfa 689;;;###autoload
492d2437 690(defun dired-other-window (dirname &optional switches)
84fc2cfa 691 "\"Edit\" directory DIRNAME. Like `dired' but selects in another window."
492d2437
RS
692 (interactive (dired-read-dir-and-switches "in other window "))
693 (switch-to-buffer-other-window (dired-noselect dirname switches)))
84fc2cfa 694
ec03e49c
RS
695;;;###autoload (define-key ctl-x-5-map "d" 'dired-other-frame)
696;;;###autoload
697(defun dired-other-frame (dirname &optional switches)
698 "\"Edit\" directory DIRNAME. Like `dired' but makes a new frame."
699 (interactive (dired-read-dir-and-switches "in other frame "))
700 (switch-to-buffer-other-frame (dired-noselect dirname switches)))
701
84fc2cfa 702;;;###autoload
8d23c16b 703(defun dired-noselect (dir-or-list &optional switches)
84fc2cfa 704 "Like `dired' but returns the dired buffer as value, does not select it."
8d23c16b 705 (or dir-or-list (setq dir-or-list default-directory))
492d2437
RS
706 ;; This loses the distinction between "/foo/*/" and "/foo/*" that
707 ;; some shells make:
54df7d9a 708 (let (dirname initially-was-dirname)
8d23c16b
ER
709 (if (consp dir-or-list)
710 (setq dirname (car dir-or-list))
711 (setq dirname dir-or-list))
54df7d9a
RS
712 (setq initially-was-dirname
713 (string= (file-name-as-directory dirname) dirname))
370b6149
RS
714 (setq dirname (abbreviate-file-name
715 (expand-file-name (directory-file-name dirname))))
cb2e51f8
RS
716 (if find-file-visit-truename
717 (setq dirname (file-truename dirname)))
54df7d9a
RS
718 ;; If the argument was syntactically a directory name not a file name,
719 ;; or if it happens to name a file that is a directory,
720 ;; convert it syntactically to a directory name.
721 ;; The reason for checking initially-was-dirname
722 ;; and not just file-directory-p
723 ;; is that file-directory-p is slow over ftp.
724 (if (or initially-was-dirname (file-directory-p dirname))
725 (setq dirname (file-name-as-directory dirname)))
8d23c16b
ER
726 (if (consp dir-or-list)
727 (setq dir-or-list (cons dirname (cdr dir-or-list)))
728 (setq dir-or-list dirname))
729 (dired-internal-noselect dir-or-list switches)))
492d2437 730
573e4d2d
LT
731;; The following is an internal dired function. It returns non-nil if
732;; the directory visited by the current dired buffer has changed on
733;; disk. DIRNAME should be the directory name of that directory.
734(defun dired-directory-changed-p (dirname)
735 (not (let ((attributes (file-attributes dirname))
e09cd94f
LT
736 (modtime (visited-file-modtime)))
737 (or (eq modtime 0)
738 (not (eq (car attributes) t))
ca02a726 739 (equal (nth 5 attributes) modtime)))))
573e4d2d
LT
740
741(defun dired-buffer-stale-p (&optional noconfirm)
742 "Return non-nil if current dired buffer needs updating.
743If NOCONFIRM is non-nil, then this function always returns nil
744for a remote directory. This feature is used by Auto Revert Mode."
745 (let ((dirname
746 (if (consp dired-directory) (car dired-directory) dired-directory)))
747 (and (stringp dirname)
748 (not (when noconfirm (file-remote-p dirname)))
749 (file-readable-p dirname)
85a3be15
MR
750 ;; Do not auto-revert when the dired buffer can be currently
751 ;; written by the user as in `wdired-mode'.
752 buffer-read-only
573e4d2d
LT
753 (dired-directory-changed-p dirname))))
754
2b3489a7
JL
755;;;###autoload
756(defcustom dired-auto-revert-buffer nil
757 "Automatically revert dired buffer on revisiting.
758If t, revisiting an existing dired buffer automatically reverts it.
759If its value is a function, call this function with the directory
760name as single argument and revert the buffer if it returns non-nil.
761Otherwise, a message offering to revert the changed dired buffer
762is displayed.
763Note that this is not the same as `auto-revert-mode' that
764periodically reverts at specified time intervals."
765 :type '(choice
766 (const :tag "Don't revert" nil)
767 (const :tag "Always revert visited dired buffer" t)
768 (const :tag "Revert changed dired buffer" dired-directory-changed-p)
769 (function :tag "Predicate function"))
770 :group 'dired
771 :version "23.2")
772
6a4cd605 773(defun dired-internal-noselect (dir-or-list &optional switches mode)
492d2437
RS
774 ;; If there is an existing dired buffer for DIRNAME, just leave
775 ;; buffer as it is (don't even call dired-revert).
776 ;; This saves time especially for deep trees or with ange-ftp.
573e4d2d 777 ;; The user can type `g' easily, and it is more consistent with find-file.
492d2437
RS
778 ;; But if SWITCHES are given they are probably different from the
779 ;; buffer's old value, so call dired-sort-other, which does
780 ;; revert the buffer.
781 ;; A pity we can't possibly do "Directory has changed - refresh? "
782 ;; like find-file does.
6a4cd605
RS
783 ;; Optional argument MODE is passed to dired-find-buffer-nocreate,
784 ;; see there.
72f16325
SM
785 (let* ((old-buf (current-buffer))
786 (dirname (if (consp dir-or-list) (car dir-or-list) dir-or-list))
787 ;; Look for an existing buffer.
788 (buffer (dired-find-buffer-nocreate dirname mode))
789 ;; Note that buffer already is in dired-mode, if found.
790 (new-buffer-p (null buffer)))
492d2437 791 (or buffer
72f16325 792 (setq buffer (create-file-buffer (directory-file-name dirname))))
492d2437 793 (set-buffer buffer)
573e4d2d
LT
794 (if (not new-buffer-p) ; existing buffer ...
795 (cond (switches ; ... but new switches
6cfd24f9 796 ;; file list may have changed
0b7bc76f 797 (setq dired-directory dir-or-list)
6cfd24f9 798 ;; this calls dired-revert
c60ee5e7 799 (dired-sort-other switches))
2b3489a7
JL
800 ;; Always revert regardless of whether it has changed or not.
801 ((eq dired-auto-revert-buffer t)
802 (revert-buffer))
803 ;; Revert when predicate function returns non-nil.
804 ((functionp dired-auto-revert-buffer)
805 (when (funcall dired-auto-revert-buffer dirname)
806 (revert-buffer)
807 (message "Changed directory automatically updated")))
6cfd24f9 808 ;; If directory has changed on disk, offer to revert.
573e4d2d 809 ((when (dired-directory-changed-p dirname)
952e8cb5 810 (message "%s"
212b2266
KH
811 (substitute-command-keys
812 "Directory has changed on disk; type \\[revert-buffer] to update Dired")))))
492d2437 813 ;; Else a new buffer
847aabce 814 (setq default-directory
e3cd4b53
RS
815 ;; We can do this unconditionally
816 ;; because dired-noselect ensures that the name
817 ;; is passed in directory name syntax
818 ;; if it was the name of a directory at all.
819 (file-name-directory dirname))
492d2437 820 (or switches (setq switches dired-listing-switches))
6e5d9ec5 821 (if mode (funcall mode)
0b7bc76f 822 (dired-mode dir-or-list switches))
492d2437
RS
823 ;; default-directory and dired-actual-switches are set now
824 ;; (buffer-local), so we can call dired-readin:
825 (let ((failed t))
826 (unwind-protect
0b7bc76f 827 (progn (dired-readin)
492d2437
RS
828 (setq failed nil))
829 ;; dired-readin can fail if parent directories are inaccessible.
830 ;; Don't leave an empty buffer around in that case.
831 (if failed (kill-buffer buffer))))
492d2437
RS
832 (goto-char (point-min))
833 (dired-initial-position dirname))
834 (set-buffer old-buf)
84fc2cfa
ER
835 buffer))
836
c5753a5d
GM
837(defvar dired-buffers nil
838 ;; Enlarged by dired-advertise
839 ;; Queried by function dired-buffers-for-dir. When this detects a
840 ;; killed buffer, it is removed from this list.
841 "Alist of expanded directories and their associated dired buffers.")
842
6a4cd605
RS
843(defun dired-find-buffer-nocreate (dirname &optional mode)
844 ;; This differs from dired-buffers-for-dir in that it does not consider
845 ;; subdirs of default-directory and searches for the first match only.
846 ;; Also, the major mode must be MODE.
0b7bc76f 847 (setq dirname (expand-file-name dirname))
f5b06a95 848 (let (found (blist dired-buffers)) ; was (buffer-list)
6a4cd605 849 (or mode (setq mode 'dired-mode))
492d2437 850 (while blist
6103c44e
KH
851 (if (null (buffer-name (cdr (car blist))))
852 (setq blist (cdr blist))
7fdbcd83 853 (with-current-buffer (cdr (car blist))
6a4cd605 854 (if (and (eq major-mode mode)
59759f1f 855 dired-directory ;; nil during find-alternate-file
0b7bc76f
RS
856 (equal dirname
857 (expand-file-name
858 (if (consp dired-directory)
859 (car dired-directory)
860 dired-directory))))
6103c44e
KH
861 (setq found (cdr (car blist))
862 blist nil)
863 (setq blist (cdr blist))))))
492d2437
RS
864 found))
865
83fadedf 866\f
492d2437
RS
867;; Read in a new dired buffer
868
0b7bc76f 869(defun dired-readin ()
d7aed37c 870 "Read in a new dired buffer.
87ae59e3 871Differs from `dired-insert-subdir' in that it accepts
d7aed37c
SM
872wildcards, erases the buffer, and builds the subdir-alist anew
873\(including making it buffer-local and clearing it first)."
874
492d2437
RS
875 ;; default-directory and dired-actual-switches must be buffer-local
876 ;; and initialized by now.
a1037423
RS
877 (let (dirname
878 ;; This makes readin much much faster.
879 ;; In particular, it prevents the font lock hook from running
880 ;; until the directory is all read in.
881 (inhibit-modification-hooks t))
0b7bc76f
RS
882 (if (consp dired-directory)
883 (setq dirname (car dired-directory))
884 (setq dirname dired-directory))
8d23c16b 885 (setq dirname (expand-file-name dirname))
8d23c16b 886 (save-excursion
0b7bc76f
RS
887 ;; This hook which may want to modify dired-actual-switches
888 ;; based on dired-directory, e.g. with ange-ftp to a SysV host
889 ;; where ls won't understand -Al switches.
890 (run-hooks 'dired-before-readin-hook)
0b7bc76f
RS
891 (if (consp buffer-undo-list)
892 (setq buffer-undo-list nil))
1419c7fc
RS
893 (make-local-variable 'file-name-coding-system)
894 (setq file-name-coding-system
895 (or coding-system-for-read file-name-coding-system))
f836b98e 896 (let ((inhibit-read-only t)
0b7bc76f
RS
897 ;; Don't make undo entries for readin.
898 (buffer-undo-list t))
8d23c16b
ER
899 (widen)
900 (erase-buffer)
0b7bc76f 901 (dired-readin-insert))
0b7bc76f 902 (goto-char (point-min))
8d23c16b
ER
903 ;; Must first make alist buffer local and set it to nil because
904 ;; dired-build-subdir-alist will call dired-clear-alist first
905 (set (make-local-variable 'dired-subdir-alist) nil)
8197b8bf 906 (dired-build-subdir-alist)
fa562dd5
RS
907 (let ((attributes (file-attributes dirname)))
908 (if (eq (car attributes) t)
909 (set-visited-file-modtime (nth 5 attributes))))
0b7bc76f
RS
910 (set-buffer-modified-p nil)
911 ;; No need to narrow since the whole buffer contains just
912 ;; dired-readin's output, nothing else. The hook can
913 ;; successfully use dired functions (e.g. dired-get-filename)
914 ;; as the subdir-alist has been built in dired-readin.
915 (run-hooks 'dired-after-readin-hook))))
492d2437
RS
916
917;; Subroutines of dired-readin
918
0b7bc76f
RS
919(defun dired-readin-insert ()
920 ;; Insert listing for the specified dir (and maybe file list)
921 ;; already in dired-directory, assuming a clean buffer.
922 (let (dir file-list)
923 (if (consp dired-directory)
924 (setq dir (car dired-directory)
925 file-list (cdr dired-directory))
926 (setq dir dired-directory
927 file-list nil))
34cd7b3c 928 (setq dir (expand-file-name dir))
0b7bc76f
RS
929 (if (and (equal "" (file-name-nondirectory dir))
930 (not file-list))
cf39fa9b 931 ;; If we are reading a whole single directory...
0b7bc76f 932 (dired-insert-directory dir dired-actual-switches nil nil t)
8d23c16b 933 (if (not (file-readable-p
0b7bc76f
RS
934 (directory-file-name (file-name-directory dir))))
935 (error "Directory %s inaccessible or nonexistent" dir)
936 ;; Else treat it as a wildcard spec
937 ;; unless we have an explicit list of files.
938 (dired-insert-directory dir dired-actual-switches
939 file-list (not file-list) t)))))
940
a12c6dca
SM
941(defun dired-align-file (beg end)
942 "Align the fields of a file to the ones of surrounding lines.
943BEG..END is the line where the file info is located."
944 ;; Some versions of ls try to adjust the size of each field so as to just
945 ;; hold the largest element ("largest" in the current invocation, of
946 ;; course). So when a single line is output, the size of each field is
947 ;; just big enough for that one output. Thus when dired refreshes one
948 ;; line, the alignment if this line w.r.t the rest is messed up because
949 ;; the fields of that one line will generally be smaller.
950 ;;
9bc260cf
MA
951 ;; To work around this problem, we here add spaces to try and
952 ;; re-align the fields as needed. Since this is purely aesthetic,
953 ;; it is of utmost importance that it doesn't mess up anything like
954 ;; `dired-move-to-filename'. To this end, we limit ourselves to
955 ;; adding spaces only, and to only add them at places where there
956 ;; was already at least one space. This way, as long as
957 ;; `directory-listing-before-filename-regexp' always matches spaces
958 ;; with "*" or "+", we know we haven't made anything worse. There
959 ;; is one spot where the exact number of spaces is important, which
960 ;; is just before the actual filename, so we refrain from adding
961 ;; spaces there (and within the filename as well, of course).
a12c6dca
SM
962 (save-excursion
963 (let (file file-col other other-col)
b4dc7d98 964 ;; Check that there is indeed a file, and that there is anoter adjacent
a12c6dca
SM
965 ;; file with which to align, and that additional spaces are needed to
966 ;; align the filenames.
967 (when (and (setq file (progn (goto-char beg)
968 (dired-move-to-filename nil end)))
969 (setq file-col (current-column))
970 (setq other
971 (or (and (goto-char beg)
972 (zerop (forward-line -1))
973 (dired-move-to-filename))
974 (and (goto-char beg)
975 (zerop (forward-line 1))
976 (dired-move-to-filename))))
977 (setq other-col (current-column))
978 (/= file other)
979 ;; Make sure there is some work left to do.
980 (> other-col file-col))
981 ;; If we've only looked at the line above, check to see if the line
982 ;; below exists as well and if so, align with the shorter one.
983 (when (and (< other file)
984 (goto-char beg)
985 (zerop (forward-line 1))
986 (dired-move-to-filename))
987 (let ((alt-col (current-column)))
988 (when (< alt-col other-col)
989 (setq other-col alt-col)
990 (setq other (point)))))
991 ;; Keep positions uptodate when we insert stuff.
992 (if (> other file) (setq other (copy-marker other)))
993 (setq file (copy-marker file))
994 ;; Main loop.
995 (goto-char beg)
87ae59e3 996 (skip-chars-forward " ") ;Skip to the first field.
a12c6dca 997 (while (and (> other-col file-col)
a12c6dca
SM
998 ;; Don't touch anything just before (and after) the
999 ;; beginning of the filename.
1000 (> file (point)))
1001 ;; We're now just in front of a field, with a space behind us.
1002 (let* ((curcol (current-column))
1003 ;; Nums are right-aligned.
1004 (num-align (looking-at "[0-9]"))
1005 ;; Let's look at the other line, in the same column: we
1006 ;; should be either near the end of the previous field, or
1007 ;; in the space between that field and the next.
1008 ;; [ Of course, it's also possible that we're already within
1009 ;; the next field or even past it, but that's unlikely since
1010 ;; other-col > file-col. ]
1011 ;; Let's find the distance to the alignment-point (either
1012 ;; the beginning or the end of the next field, depending on
1013 ;; whether this field is left or right aligned).
1014 (align-pt-offset
1015 (save-excursion
1016 (goto-char other)
1017 (move-to-column curcol)
1018 (when (looking-at
1019 (concat
ee680b2b 1020 (if (eq (char-before) ?\s) " *" "[^ ]* *")
a12c6dca
SM
1021 (if num-align "[0-9][^ ]*")))
1022 (- (match-end 0) (match-beginning 0)))))
1023 ;; Now, the number of spaces to insert is align-pt-offset
1024 ;; minus the distance to the equivalent point on the
1025 ;; current line.
1026 (spaces
1027 (if (not num-align)
1028 align-pt-offset
1029 (and align-pt-offset
1030 (save-excursion
1031 (skip-chars-forward "^ ")
1032 (- align-pt-offset (- (current-column) curcol)))))))
1033 (when (and spaces (> spaces 0))
1034 (setq file-col (+ spaces file-col))
1035 (if (> file-col other-col)
1036 (setq spaces (- spaces (- file-col other-col))))
1037 (insert-char ?\s spaces)
1038 ;; Let's just make really sure we did not mess up.
1039 (unless (save-excursion
87ae59e3 1040 (eq (dired-move-to-filename) (marker-position file)))
a12c6dca 1041 ;; Damn! We messed up: let's revert the change.
87ae59e3
SM
1042 (delete-char (- spaces)))))
1043 ;; Now skip to next field.
1044 (skip-chars-forward "^ ") (skip-chars-forward " "))
a12c6dca 1045 (set-marker file nil)))))
87ae59e3 1046
a12c6dca 1047
0b7bc76f
RS
1048(defun dired-insert-directory (dir switches &optional file-list wildcard hdr)
1049 "Insert a directory listing of DIR, Dired style.
1050Use SWITCHES to make the listings.
1051If FILE-LIST is non-nil, list only those files.
1052Otherwise, if WILDCARD is non-nil, expand wildcards;
1053 in that case, DIR should be a file name that uses wildcards.
1054In other cases, DIR should be a directory name or a directory filename.
1055If HDR is non-nil, insert a header line with the directory name."
9888aa65 1056 (let ((opoint (point))
02b5d79c 1057 (process-environment (copy-sequence process-environment))
9888aa65 1058 end)
1fc85dae 1059 (if (or dired-use-ls-dired (file-remote-p dir))
0b7bc76f 1060 (setq switches (concat "--dired " switches)))
6492483f
RS
1061 ;; We used to specify the C locale here, to force English month names;
1062 ;; but this should not be necessary any more,
9bc260cf 1063 ;; with the new value of `directory-listing-before-filename-regexp'.
0b7bc76f
RS
1064 (if file-list
1065 (dolist (f file-list)
a12c6dca
SM
1066 (let ((beg (point)))
1067 (insert-directory f switches nil nil)
1068 ;; Re-align fields, if necessary.
1069 (dired-align-file beg (point))))
0b7bc76f 1070 (insert-directory dir switches wildcard (not wildcard)))
9888aa65 1071 ;; Quote certain characters, unless ls quoted them for us.
ad632492
SM
1072 (if (not (string-match "b" dired-actual-switches))
1073 (save-excursion
1074 (setq end (point-marker))
1075 (goto-char opoint)
1076 (while (search-forward "\\" end t)
2bb27597
AS
1077 (replace-match (apply #'propertize
1078 "\\\\"
1079 (text-properties-at (match-beginning 0)))
1080 nil t))
ad632492
SM
1081 (goto-char opoint)
1082 (while (search-forward "\^m" end t)
2bb27597
AS
1083 (replace-match (apply #'propertize
1084 "\\015"
1085 (text-properties-at (match-beginning 0)))
1086 nil t))
ad632492 1087 (set-marker end nil)))
0b7bc76f
RS
1088 (dired-insert-set-properties opoint (point))
1089 ;; If we used --dired and it worked, the lines are already indented.
1090 ;; Otherwise, indent them.
1091 (unless (save-excursion
1ba6c0f2 1092 (goto-char opoint)
0b7bc76f
RS
1093 (looking-at " "))
1094 (let ((indent-tabs-mode nil))
1095 (indent-rigidly opoint (point) 2)))
1096 ;; Insert text at the beginning to standardize things.
1097 (save-excursion
1098 (goto-char opoint)
a7f07c36
SM
1099 (if (and (or hdr wildcard)
1100 (not (and (looking-at "^ \\(.*\\):$")
1101 (file-name-absolute-p (match-string 1)))))
0b7bc76f
RS
1102 ;; Note that dired-build-subdir-alist will replace the name
1103 ;; by its expansion, so it does not matter whether what we insert
1104 ;; here is fully expanded, but it should be absolute.
1105 (insert " " (directory-file-name (file-name-directory dir)) ":\n"))
1106 (when wildcard
1107 ;; Insert "wildcard" line where "total" line would be for a full dir.
1108 (insert " wildcard " (file-name-nondirectory dir) "\n")))))
492d2437 1109
cb88a3db 1110(defun dired-insert-set-properties (beg end)
d7aed37c 1111 "Make the file names highlight when the mouse is on them."
cb88a3db
RS
1112 (save-excursion
1113 (goto-char beg)
1114 (while (< (point) end)
7da0e9b4
RS
1115 (condition-case nil
1116 (if (dired-move-to-filename)
ac2d0299
EZ
1117 (add-text-properties
1118 (point)
1119 (save-excursion
1120 (dired-move-to-end-of-filename)
1121 (point))
1b85bd12 1122 '(mouse-face highlight
eae2c85e 1123 dired-filename t
ac2d0299 1124 help-echo "mouse-2: visit this file in other window")))
7da0e9b4 1125 (error nil))
cb88a3db 1126 (forward-line 1))))
83fadedf 1127\f
492d2437
RS
1128;; Reverting a dired buffer
1129
84fc2cfa 1130(defun dired-revert (&optional arg noconfirm)
d7aed37c 1131 "Reread the dired buffer.
ee680b2b 1132Must also be called after `dired-actual-switches' have changed.
d7aed37c
SM
1133Should not fail even on completely garbaged buffers.
1134Preserves old cursor, marks/flags, hidden-p."
492d2437 1135 (widen) ; just in case user narrowed
7805cdbd 1136 (let ((modflag (buffer-modified-p))
05404988 1137 (positions (dired-save-positions))
492d2437
RS
1138 (mark-alist nil) ; save marked files
1139 (hidden-subdirs (dired-remember-hidden))
1140 (old-subdir-alist (cdr (reverse dired-subdir-alist))) ; except pwd
1141 (case-fold-search nil) ; we check for upper case ls flags
f836b98e 1142 (inhibit-read-only t))
492d2437
RS
1143 (goto-char (point-min))
1144 (setq mark-alist;; only after dired-remember-hidden since this unhides:
1145 (dired-remember-marks (point-min) (point-max)))
1146 ;; treat top level dir extra (it may contain wildcards)
d5b3979c
MA
1147 (if (not (consp dired-directory))
1148 (dired-uncache dired-directory)
1149 (dired-uncache (car dired-directory))
1150 (dolist (dir (cdr dired-directory))
1151 (if (file-name-absolute-p dir)
1152 (dired-uncache dir))))
6a80f50e 1153 ;; Run dired-after-readin-hook just once, below.
492d2437 1154 (let ((dired-after-readin-hook nil))
6a80f50e 1155 (dired-readin)
492d2437
RS
1156 (dired-insert-old-subdirs old-subdir-alist))
1157 (dired-mark-remembered mark-alist) ; mark files that were marked
1158 ;; ... run the hook for the whole buffer, and only after markers
1159 ;; have been reinserted (else omitting in dired-x would omit marked files)
1160 (run-hooks 'dired-after-readin-hook) ; no need to narrow
05404988 1161 (dired-restore-positions positions)
492d2437 1162 (save-excursion ; hide subdirs that were hidden
d7aed37c
SM
1163 (dolist (dir hidden-subdirs)
1164 (if (dired-goto-subdir dir)
7805cdbd
LT
1165 (dired-hide-subdir 1))))
1166 (unless modflag (restore-buffer-modified-p nil)))
492d2437 1167 ;; outside of the let scope
7805cdbd 1168;;; Might as well not override the user if the user changed this.
492d2437
RS
1169;;; (setq buffer-read-only t)
1170 )
1171
1172;; Subroutines of dired-revert
1173;; Some of these are also used when inserting subdirs.
1174
05404988 1175(defun dired-save-positions ()
065543e7
JL
1176 "Return current positions in the buffer and all windows with this directory.
1177The positions have the form (BUFFER-POSITION WINDOW-POSITIONS).
1178
1179BUFFER-POSITION is the point position in the current dired buffer.
1180The buffer position have the form (BUFFER DIRED-FILENAME BUFFER-POINT).
1181
1182WINDOW-POSITIONS are current positions in all windows displaying
1183this dired buffer. The window positions have the form (WINDOW
1184DIRED-FILENAME WINDOW-POINT)."
1185 (list
1186 (list (current-buffer) (dired-get-filename nil t) (point))
1187 (mapcar (lambda (w)
1188 (list w
1189 (with-selected-window w
1190 (dired-get-filename nil t))
1191 (window-point w)))
1192 (get-buffer-window-list nil 0 t))))
05404988
SM
1193
1194(defun dired-restore-positions (positions)
1195 "Restore POSITIONS saved with `dired-save-positions'."
065543e7
JL
1196 (let* ((buf-file-pos (nth 0 positions))
1197 (buffer (nth 0 buf-file-pos)))
1198 (unless (and (nth 1 buf-file-pos)
1199 (dired-goto-file (nth 1 buf-file-pos)))
1200 (goto-char (nth 2 buf-file-pos))
1201 (dired-move-to-filename))
1202 (dolist (win-file-pos (nth 1 positions))
1203 ;; Ensure that window still displays the original buffer.
1204 (when (eq (window-buffer (nth 0 win-file-pos)) buffer)
1205 (with-selected-window (nth 0 win-file-pos)
1206 (unless (and (nth 1 win-file-pos)
1207 (dired-goto-file (nth 1 win-file-pos)))
1208 (goto-char (nth 2 win-file-pos))
1209 (dired-move-to-filename)))))))
05404988 1210
492d2437 1211(defun dired-remember-marks (beg end)
d7aed37c 1212 "Return alist of files and their marks, from BEG to END."
492d2437 1213 (if selective-display ; must unhide to make this work.
f836b98e 1214 (let ((inhibit-read-only t))
492d2437
RS
1215 (subst-char-in-region beg end ?\r ?\n)))
1216 (let (fil chr alist)
1217 (save-excursion
1218 (goto-char beg)
1219 (while (re-search-forward dired-re-mark end t)
1220 (if (setq fil (dired-get-filename nil t))
1221 (setq chr (preceding-char)
1222 alist (cons (cons fil chr) alist)))))
1223 alist))
1224
492d2437 1225(defun dired-mark-remembered (alist)
d7aed37c
SM
1226 "Mark all files remembered in ALIST.
1227Each element of ALIST looks like (FILE . MARKERCHAR)."
492d2437
RS
1228 (let (elt fil chr)
1229 (while alist
1230 (setq elt (car alist)
1231 alist (cdr alist)
1232 fil (car elt)
1233 chr (cdr elt))
1234 (if (dired-goto-file fil)
1235 (save-excursion
1236 (beginning-of-line)
1237 (delete-char 1)
1238 (insert chr))))))
1239
492d2437 1240(defun dired-remember-hidden ()
d7aed37c 1241 "Return a list of names of subdirs currently hidden."
492d2437
RS
1242 (let ((l dired-subdir-alist) dir pos result)
1243 (while l
1244 (setq dir (car (car l))
1245 pos (cdr (car l))
1246 l (cdr l))
1247 (goto-char pos)
1248 (skip-chars-forward "^\r\n")
52041219 1249 (if (eq (following-char) ?\r)
492d2437
RS
1250 (setq result (cons dir result))))
1251 result))
1252
492d2437 1253(defun dired-insert-old-subdirs (old-subdir-alist)
d7aed37c
SM
1254 "Try to insert all subdirs that were displayed before.
1255Do so according to the former subdir alist OLD-SUBDIR-ALIST."
492d2437
RS
1256 (or (string-match "R" dired-actual-switches)
1257 (let (elt dir)
1258 (while old-subdir-alist
1259 (setq elt (car old-subdir-alist)
1260 old-subdir-alist (cdr old-subdir-alist)
1261 dir (car elt))
1262 (condition-case ()
715984d3
RS
1263 (progn
1264 (dired-uncache dir)
f817c0fb 1265 (dired-insert-subdir dir))
492d2437 1266 (error nil))))))
715984d3 1267
715984d3 1268(defun dired-uncache (dir)
d7aed37c 1269 "Remove directory DIR from any directory cache."
6eaebaa2 1270 (let ((handler (find-file-name-handler dir 'dired-uncache)))
715984d3
RS
1271 (if handler
1272 (funcall handler 'dired-uncache dir))))
83fadedf 1273\f
492d2437 1274;; dired mode key bindings and initialization
84fc2cfa 1275
d7aed37c 1276(defvar dired-mode-map
492d2437
RS
1277 ;; This looks ugly when substitute-command-keys uses C-d instead d:
1278 ;; (define-key dired-mode-map "\C-d" 'dired-flag-file-deletion)
3e1fb00f
RS
1279 (let ((map (make-keymap)))
1280 (suppress-keymap map)
1281 (define-key map [mouse-2] 'dired-mouse-find-file-other-window)
bb87fbc3 1282 (define-key map [follow-link] 'mouse-face)
3e1fb00f
RS
1283 ;; Commands to mark or flag certain categories of files
1284 (define-key map "#" 'dired-flag-auto-save-files)
3e1fb00f 1285 (define-key map "." 'dired-clean-directory)
3e1fb00f
RS
1286 (define-key map "~" 'dired-flag-backup-files)
1287 ;; Upper case keys (except !) for operating on the marked files
1288 (define-key map "A" 'dired-do-search)
1289 (define-key map "C" 'dired-do-copy)
1290 (define-key map "B" 'dired-do-byte-compile)
1291 (define-key map "D" 'dired-do-delete)
1292 (define-key map "G" 'dired-do-chgrp)
1293 (define-key map "H" 'dired-do-hardlink)
1294 (define-key map "L" 'dired-do-load)
1295 (define-key map "M" 'dired-do-chmod)
1296 (define-key map "O" 'dired-do-chown)
1297 (define-key map "P" 'dired-do-print)
ee93b692 1298 (define-key map "Q" 'dired-do-query-replace-regexp)
3e1fb00f
RS
1299 (define-key map "R" 'dired-do-rename)
1300 (define-key map "S" 'dired-do-symlink)
57654b8c 1301 (define-key map "T" 'dired-do-touch)
3e1fb00f
RS
1302 (define-key map "X" 'dired-do-shell-command)
1303 (define-key map "Z" 'dired-do-compress)
1304 (define-key map "!" 'dired-do-shell-command)
48e740bf 1305 (define-key map "&" 'dired-do-async-shell-command)
3e1fb00f
RS
1306 ;; Comparison commands
1307 (define-key map "=" 'dired-diff)
1308 (define-key map "\M-=" 'dired-backup-diff)
1309 ;; Tree Dired commands
1310 (define-key map "\M-\C-?" 'dired-unmark-all-files)
1311 (define-key map "\M-\C-d" 'dired-tree-down)
1312 (define-key map "\M-\C-u" 'dired-tree-up)
1313 (define-key map "\M-\C-n" 'dired-next-subdir)
1314 (define-key map "\M-\C-p" 'dired-prev-subdir)
1315 ;; move to marked files
1316 (define-key map "\M-{" 'dired-prev-marked-file)
1317 (define-key map "\M-}" 'dired-next-marked-file)
1318 ;; Make all regexp commands share a `%' prefix:
1319 ;; We used to get to the submap via a symbol dired-regexp-prefix,
1320 ;; but that seems to serve little purpose, and copy-keymap
1321 ;; does a better job without it.
1322 (define-key map "%" nil)
1323 (define-key map "%u" 'dired-upcase)
1324 (define-key map "%l" 'dired-downcase)
1325 (define-key map "%d" 'dired-flag-files-regexp)
e9b8e22d 1326 (define-key map "%g" 'dired-mark-files-containing-regexp)
3e1fb00f
RS
1327 (define-key map "%m" 'dired-mark-files-regexp)
1328 (define-key map "%r" 'dired-do-rename-regexp)
1329 (define-key map "%C" 'dired-do-copy-regexp)
1330 (define-key map "%H" 'dired-do-hardlink-regexp)
1331 (define-key map "%R" 'dired-do-rename-regexp)
1332 (define-key map "%S" 'dired-do-symlink-regexp)
48e740bf 1333 (define-key map "%&" 'dired-flag-garbage-files)
4a3ca6ed
RS
1334 ;; Commands for marking and unmarking.
1335 (define-key map "*" nil)
1336 (define-key map "**" 'dired-mark-executables)
1337 (define-key map "*/" 'dired-mark-directories)
1338 (define-key map "*@" 'dired-mark-symlinks)
1339 (define-key map "*%" 'dired-mark-files-regexp)
1340 (define-key map "*c" 'dired-change-marks)
0609c998 1341 (define-key map "*s" 'dired-mark-subdir-files)
4a3ca6ed
RS
1342 (define-key map "*m" 'dired-mark)
1343 (define-key map "*u" 'dired-unmark)
1344 (define-key map "*?" 'dired-unmark-all-files)
534a6edf 1345 (define-key map "*!" 'dired-unmark-all-marks)
d7aed37c 1346 (define-key map "U" 'dired-unmark-all-marks)
4a3ca6ed
RS
1347 (define-key map "*\177" 'dired-unmark-backward)
1348 (define-key map "*\C-n" 'dired-next-marked-file)
1349 (define-key map "*\C-p" 'dired-prev-marked-file)
d588eb90 1350 (define-key map "*t" 'dired-toggle-marks)
3e1fb00f 1351 ;; Lower keys for commands not operating on all the marked files
c5753a5d 1352 (define-key map "a" 'dired-find-alternate-file)
3e1fb00f
RS
1353 (define-key map "d" 'dired-flag-file-deletion)
1354 (define-key map "e" 'dired-find-file)
1355 (define-key map "f" 'dired-find-file)
8cb95edf
SM
1356 (define-key map "\C-m" 'dired-find-file)
1357 (put 'dired-find-file :advertised-binding "\C-m")
3e1fb00f
RS
1358 (define-key map "g" 'revert-buffer)
1359 (define-key map "h" 'describe-mode)
1360 (define-key map "i" 'dired-maybe-insert-subdir)
e19d2d64 1361 (define-key map "j" 'dired-goto-file)
3e1fb00f
RS
1362 (define-key map "k" 'dired-do-kill-lines)
1363 (define-key map "l" 'dired-do-redisplay)
1364 (define-key map "m" 'dired-mark)
1365 (define-key map "n" 'dired-next-line)
1366 (define-key map "o" 'dired-find-file-other-window)
1367 (define-key map "\C-o" 'dired-display-file)
1368 (define-key map "p" 'dired-previous-line)
da8a8438 1369 (define-key map "q" 'quit-window)
3e1fb00f 1370 (define-key map "s" 'dired-sort-toggle-or-edit)
d588eb90 1371 (define-key map "t" 'dired-toggle-marks)
3e1fb00f
RS
1372 (define-key map "u" 'dired-unmark)
1373 (define-key map "v" 'dired-view-file)
a3f4a3ef 1374 (define-key map "w" 'dired-copy-filename-as-kill)
3e1fb00f 1375 (define-key map "x" 'dired-do-flagged-delete)
d1e99fa5 1376 (define-key map "y" 'dired-show-file-type)
3e1fb00f
RS
1377 (define-key map "+" 'dired-create-directory)
1378 ;; moving
1379 (define-key map "<" 'dired-prev-dirline)
1380 (define-key map ">" 'dired-next-dirline)
1381 (define-key map "^" 'dired-up-directory)
1382 (define-key map " " 'dired-next-line)
1383 (define-key map "\C-n" 'dired-next-line)
1384 (define-key map "\C-p" 'dired-previous-line)
1385 (define-key map [down] 'dired-next-line)
1386 (define-key map [up] 'dired-previous-line)
1387 ;; hiding
1388 (define-key map "$" 'dired-hide-subdir)
1389 (define-key map "\M-$" 'dired-hide-all)
b89b46cf
JL
1390 ;; isearch
1391 (define-key map (kbd "M-s a C-s") 'dired-do-isearch)
1392 (define-key map (kbd "M-s a M-C-s") 'dired-do-isearch-regexp)
eae2c85e
JL
1393 (define-key map (kbd "M-s f C-s") 'dired-isearch-filenames)
1394 (define-key map (kbd "M-s f M-C-s") 'dired-isearch-filenames-regexp)
3e1fb00f 1395 ;; misc
40aa8257 1396 (define-key map "\C-x\C-q" 'dired-toggle-read-only)
3e1fb00f
RS
1397 (define-key map "?" 'dired-summary)
1398 (define-key map "\177" 'dired-unmark-backward)
5e5a3412
RS
1399 (define-key map [remap undo] 'dired-undo)
1400 (define-key map [remap advertised-undo] 'dired-undo)
aa1a7612
CY
1401 ;; thumbnail manipulation (image-dired)
1402 (define-key map "\C-td" 'image-dired-display-thumbs)
1403 (define-key map "\C-tt" 'image-dired-tag-files)
1404 (define-key map "\C-tr" 'image-dired-delete-tag)
1405 (define-key map "\C-tj" 'image-dired-jump-thumbnail-buffer)
1406 (define-key map "\C-ti" 'image-dired-dired-display-image)
1407 (define-key map "\C-tx" 'image-dired-dired-display-external)
1408 (define-key map "\C-ta" 'image-dired-display-thumbs-append)
1409 (define-key map "\C-t." 'image-dired-display-thumb)
1410 (define-key map "\C-tc" 'image-dired-dired-comment-files)
1411 (define-key map "\C-tf" 'image-dired-mark-tagged-files)
84fb0956 1412 (define-key map "\C-t\C-t" 'image-dired-dired-toggle-marked-thumbs)
aa1a7612 1413 (define-key map "\C-te" 'image-dired-dired-edit-comment-and-tags)
bfeee9d1
DN
1414 ;; encryption and decryption (epa-dired)
1415 (define-key map ":d" 'epa-dired-do-decrypt)
1416 (define-key map ":v" 'epa-dired-do-verify)
1417 (define-key map ":s" 'epa-dired-do-sign)
1418 (define-key map ":e" 'epa-dired-do-encrypt)
3e1fb00f
RS
1419
1420 ;; Make menu bar items.
1421
d066de8e
EZ
1422 ;; No need to fo this, now that top-level items are fewer.
1423 ;;;;
3e1fb00f 1424 ;; Get rid of the Edit menu bar item to save space.
d066de8e 1425 ;(define-key map [menu-bar edit] 'undefined)
3e1fb00f
RS
1426
1427 (define-key map [menu-bar subdir]
1428 (cons "Subdir" (make-sparse-keymap "Subdir")))
1429
1430 (define-key map [menu-bar subdir hide-all]
d066de8e
EZ
1431 '(menu-item "Hide All" dired-hide-all
1432 :help "Hide all subdirectories, leave only header lines"))
3e1fb00f 1433 (define-key map [menu-bar subdir hide-subdir]
d066de8e
EZ
1434 '(menu-item "Hide/UnHide Subdir" dired-hide-subdir
1435 :help "Hide or unhide current directory listing"))
3e1fb00f 1436 (define-key map [menu-bar subdir tree-down]
d066de8e
EZ
1437 '(menu-item "Tree Down" dired-tree-down
1438 :help "Go to first subdirectory header down the tree"))
3e1fb00f 1439 (define-key map [menu-bar subdir tree-up]
d066de8e
EZ
1440 '(menu-item "Tree Up" dired-tree-up
1441 :help "Go to first subdirectory header up the tree"))
3e1fb00f 1442 (define-key map [menu-bar subdir up]
d066de8e
EZ
1443 '(menu-item "Up Directory" dired-up-directory
1444 :help "Edit the parent directory"))
3e1fb00f 1445 (define-key map [menu-bar subdir prev-subdir]
d066de8e
EZ
1446 '(menu-item "Prev Subdir" dired-prev-subdir
1447 :help "Go to previous subdirectory header line"))
3e1fb00f 1448 (define-key map [menu-bar subdir next-subdir]
d066de8e
EZ
1449 '(menu-item "Next Subdir" dired-next-subdir
1450 :help "Go to next subdirectory header line"))
3e1fb00f 1451 (define-key map [menu-bar subdir prev-dirline]
d066de8e
EZ
1452 '(menu-item "Prev Dirline" dired-prev-dirline
1453 :help "Move to next directory-file line"))
3e1fb00f 1454 (define-key map [menu-bar subdir next-dirline]
d066de8e
EZ
1455 '(menu-item "Next Dirline" dired-next-dirline
1456 :help "Move to previous directory-file line"))
3e1fb00f 1457 (define-key map [menu-bar subdir insert]
d066de8e 1458 '(menu-item "Insert This Subdir" dired-maybe-insert-subdir
bedd8a58
CY
1459 :help "Insert contents of subdirectory"
1460 :enable (let ((f (dired-get-filename nil t)))
1461 (and f (file-directory-p f)))))
3e1fb00f
RS
1462 (define-key map [menu-bar immediate]
1463 (cons "Immediate" (make-sparse-keymap "Immediate")))
1464
635abd82 1465 (define-key map
aa1a7612
CY
1466 [menu-bar immediate image-dired-dired-display-external]
1467 '(menu-item "Display Image Externally" image-dired-dired-display-external
bc4dbed5 1468 :help "Display image in external viewer"))
635abd82 1469 (define-key map
aa1a7612
CY
1470 [menu-bar immediate image-dired-dired-display-image]
1471 '(menu-item "Display Image" image-dired-dired-display-image
bc4dbed5 1472 :help "Display sized image in a separate window"))
36938994 1473
836788c9
MD
1474 (define-key map [menu-bar immediate revert-buffer]
1475 '(menu-item "Refresh" revert-buffer
1476 :help "Update contents of shown directories"))
1477
1478 (define-key map [menu-bar immediate dashes]
1479 '("--"))
635abd82 1480
eae2c85e
JL
1481 (define-key map [menu-bar immediate isearch-filenames-regexp]
1482 '(menu-item "Isearch Regexp in File Names..." dired-isearch-filenames-regexp
1483 :help "Incrementally search for regexp in file names only"))
1484 (define-key map [menu-bar immediate isearch-filenames]
1485 '(menu-item "Isearch in File Names..." dired-isearch-filenames
1486 :help "Incrementally search for string in file names only."))
0e2aaf98 1487 (define-key map [menu-bar immediate compare-directories]
27af5d58 1488 '(menu-item "Compare Directories..." dired-compare-directories
0e2aaf98 1489 :help "Mark files with different attributes in two dired buffers"))
3e1fb00f 1490 (define-key map [menu-bar immediate backup-diff]
d066de8e
EZ
1491 '(menu-item "Compare with Backup" dired-backup-diff
1492 :help "Diff file at cursor with its latest backup"))
3e1fb00f 1493 (define-key map [menu-bar immediate diff]
d066de8e
EZ
1494 '(menu-item "Diff..." dired-diff
1495 :help "Compare file at cursor with another file"))
3e1fb00f 1496 (define-key map [menu-bar immediate view]
d066de8e
EZ
1497 '(menu-item "View This File" dired-view-file
1498 :help "Examine file at cursor in read-only mode"))
3e1fb00f 1499 (define-key map [menu-bar immediate display]
d066de8e
EZ
1500 '(menu-item "Display in Other Window" dired-display-file
1501 :help "Display file at cursor in other window"))
3e1fb00f 1502 (define-key map [menu-bar immediate find-file-other-window]
d066de8e
EZ
1503 '(menu-item "Find in Other Window" dired-find-file-other-window
1504 :help "Edit file at cursor in other window"))
3e1fb00f 1505 (define-key map [menu-bar immediate find-file]
d066de8e
EZ
1506 '(menu-item "Find This File" dired-find-file
1507 :help "Edit file at cursor"))
3e1fb00f 1508 (define-key map [menu-bar immediate create-directory]
4b33a64a
DN
1509 '(menu-item "Create Directory..." dired-create-directory
1510 :help "Create a directory"))
2ecab840 1511 (define-key map [menu-bar immediate wdired-mode]
40aa8257 1512 '(menu-item "Edit File Names" wdired-change-to-wdired-mode
4b33a64a 1513 :help "Put a dired buffer in a mode in which filenames are editable"
89e87059 1514 :keys "C-x C-q"
40aa8257 1515 :filter (lambda (x) (if (eq major-mode 'dired-mode) x))))
3e1fb00f
RS
1516
1517 (define-key map [menu-bar regexp]
1518 (cons "Regexp" (make-sparse-keymap "Regexp")))
1519
836788c9 1520 (define-key map
aa1a7612
CY
1521 [menu-bar regexp image-dired-mark-tagged-files]
1522 '(menu-item "Mark From Image Tag..." image-dired-mark-tagged-files
098bab71
JB
1523 :help "Mark files whose image tags matches regexp"))
1524
836788c9 1525 (define-key map [menu-bar regexp dashes-1]
098bab71 1526 '("--"))
836788c9 1527
3e1fb00f 1528 (define-key map [menu-bar regexp downcase]
d066de8e
EZ
1529 '(menu-item "Downcase" dired-downcase
1530 ;; When running on plain MS-DOS, there's only one
1531 ;; letter-case for file names.
1532 :enable (or (not (fboundp 'msdos-long-file-names))
1533 (msdos-long-file-names))
1534 :help "Rename marked files to lower-case name"))
3e1fb00f 1535 (define-key map [menu-bar regexp upcase]
d066de8e
EZ
1536 '(menu-item "Upcase" dired-upcase
1537 :enable (or (not (fboundp 'msdos-long-file-names))
1538 (msdos-long-file-names))
1539 :help "Rename marked files to upper-case name"))
3e1fb00f 1540 (define-key map [menu-bar regexp hardlink]
d066de8e
EZ
1541 '(menu-item "Hardlink..." dired-do-hardlink-regexp
1542 :help "Make hard links for files matching regexp"))
3e1fb00f 1543 (define-key map [menu-bar regexp symlink]
d066de8e
EZ
1544 '(menu-item "Symlink..." dired-do-symlink-regexp
1545 :visible (fboundp 'make-symbolic-link)
1546 :help "Make symbolic links for files matching regexp"))
3e1fb00f 1547 (define-key map [menu-bar regexp rename]
d066de8e
EZ
1548 '(menu-item "Rename..." dired-do-rename-regexp
1549 :help "Rename marked files matching regexp"))
3e1fb00f 1550 (define-key map [menu-bar regexp copy]
d066de8e
EZ
1551 '(menu-item "Copy..." dired-do-copy-regexp
1552 :help "Copy marked files matching regexp"))
3e1fb00f 1553 (define-key map [menu-bar regexp flag]
d066de8e
EZ
1554 '(menu-item "Flag..." dired-flag-files-regexp
1555 :help "Flag files matching regexp for deletion"))
3e1fb00f 1556 (define-key map [menu-bar regexp mark]
d066de8e
EZ
1557 '(menu-item "Mark..." dired-mark-files-regexp
1558 :help "Mark files matching regexp for future operations"))
aa924deb 1559 (define-key map [menu-bar regexp mark-cont]
d066de8e
EZ
1560 '(menu-item "Mark Containing..." dired-mark-files-containing-regexp
1561 :help "Mark files whose contents matches regexp"))
3e1fb00f
RS
1562
1563 (define-key map [menu-bar mark]
1564 (cons "Mark" (make-sparse-keymap "Mark")))
1565
1566 (define-key map [menu-bar mark prev]
d066de8e
EZ
1567 '(menu-item "Previous Marked" dired-prev-marked-file
1568 :help "Move to previous marked file"))
3e1fb00f 1569 (define-key map [menu-bar mark next]
d066de8e
EZ
1570 '(menu-item "Next Marked" dired-next-marked-file
1571 :help "Move to next marked file"))
3e1fb00f 1572 (define-key map [menu-bar mark marks]
d066de8e
EZ
1573 '(menu-item "Change Marks..." dired-change-marks
1574 :help "Replace marker with another character"))
3e1fb00f 1575 (define-key map [menu-bar mark unmark-all]
d066de8e 1576 '(menu-item "Unmark All" dired-unmark-all-marks))
3e1fb00f 1577 (define-key map [menu-bar mark symlinks]
d066de8e
EZ
1578 '(menu-item "Mark Symlinks" dired-mark-symlinks
1579 :visible (fboundp 'make-symbolic-link)
1580 :help "Mark all symbolic links"))
3e1fb00f 1581 (define-key map [menu-bar mark directories]
d066de8e
EZ
1582 '(menu-item "Mark Directories" dired-mark-directories
1583 :help "Mark all directories except `.' and `..'"))
3e1fb00f 1584 (define-key map [menu-bar mark directory]
d066de8e
EZ
1585 '(menu-item "Mark Old Backups" dired-clean-directory
1586 :help "Flag old numbered backups for deletion"))
3e1fb00f 1587 (define-key map [menu-bar mark executables]
d066de8e
EZ
1588 '(menu-item "Mark Executables" dired-mark-executables
1589 :help "Mark all executable files"))
84d3f6e8 1590 (define-key map [menu-bar mark garbage-files]
d066de8e
EZ
1591 '(menu-item "Flag Garbage Files" dired-flag-garbage-files
1592 :help "Flag unneeded files for deletion"))
3e1fb00f 1593 (define-key map [menu-bar mark backup-files]
d066de8e
EZ
1594 '(menu-item "Flag Backup Files" dired-flag-backup-files
1595 :help "Flag all backup files for deletion"))
3e1fb00f 1596 (define-key map [menu-bar mark auto-save-files]
d066de8e
EZ
1597 '(menu-item "Flag Auto-save Files" dired-flag-auto-save-files
1598 :help "Flag auto-save files for deletion"))
3e1fb00f 1599 (define-key map [menu-bar mark deletion]
d066de8e
EZ
1600 '(menu-item "Flag" dired-flag-file-deletion
1601 :help "Flag current line's file for deletion"))
3e1fb00f 1602 (define-key map [menu-bar mark unmark]
d066de8e
EZ
1603 '(menu-item "Unmark" dired-unmark
1604 :help "Unmark or unflag current line's file"))
3e1fb00f 1605 (define-key map [menu-bar mark mark]
d066de8e
EZ
1606 '(menu-item "Mark" dired-mark
1607 :help "Mark current line's file for future operations"))
e5f0841e 1608 (define-key map [menu-bar mark toggle-marks]
d588eb90 1609 '(menu-item "Toggle Marks" dired-toggle-marks
d066de8e 1610 :help "Mark unmarked files, unmark marked ones"))
3e1fb00f
RS
1611
1612 (define-key map [menu-bar operate]
1613 (cons "Operate" (make-sparse-keymap "Operate")))
1614
836788c9 1615 (define-key map
aa1a7612
CY
1616 [menu-bar operate image-dired-delete-tag]
1617 '(menu-item "Delete Image Tag..." image-dired-delete-tag
b305952d 1618 :help "Delete image tag from current or marked files"))
836788c9 1619 (define-key map
aa1a7612
CY
1620 [menu-bar operate image-dired-tag-files]
1621 '(menu-item "Add Image Tags..." image-dired-tag-files
836788c9
MD
1622 :help "Add image tags to current or marked files"))
1623 (define-key map
aa1a7612
CY
1624 [menu-bar operate image-dired-dired-comment-files]
1625 '(menu-item "Add Image Comment..." image-dired-dired-comment-files
836788c9
MD
1626 :help "Add image comment to current or marked files"))
1627 (define-key map
aa1a7612 1628 [menu-bar operate image-dired-display-thumbs]
a41925a2
JL
1629 '(menu-item "Display image thumbnails" image-dired-display-thumbs
1630 :help "Display image thumbnails for current or marked image files"))
098bab71 1631
7cce3c91
CY
1632 (define-key map [menu-bar operate dashes-4]
1633 '("--"))
1634
1635 (define-key map
1636 [menu-bar operate epa-dired-do-decrypt]
1637 '(menu-item "Decrypt" epa-dired-do-decrypt
1638 :help "Decrypt file at cursor"))
1639
1640 (define-key map
1641 [menu-bar operate epa-dired-do-verify]
1642 '(menu-item "Verify" epa-dired-do-verify
1643 :help "Verify digital signature of file at cursor"))
1644
1645 (define-key map
1646 [menu-bar operate epa-dired-do-sign]
1647 '(menu-item "Sign" epa-dired-do-sign
1648 :help "Create digital signature of file at cursor"))
1649
1650 (define-key map
1651 [menu-bar operate epa-dired-do-encrypt]
1652 '(menu-item "Encrypt" epa-dired-do-encrypt
1653 :help "Encrypt file at cursor"))
1654
836788c9 1655 (define-key map [menu-bar operate dashes-3]
098bab71 1656 '("--"))
836788c9 1657
3e1fb00f 1658 (define-key map [menu-bar operate query-replace]
ee93b692 1659 '(menu-item "Query Replace in Files..." dired-do-query-replace-regexp
d066de8e 1660 :help "Replace regexp in marked files"))
3e1fb00f 1661 (define-key map [menu-bar operate search]
d066de8e
EZ
1662 '(menu-item "Search Files..." dired-do-search
1663 :help "Search marked files for regexp"))
b89b46cf
JL
1664 (define-key map [menu-bar operate isearch-regexp]
1665 '(menu-item "Isearch Regexp Files..." dired-do-isearch-regexp
1666 :help "Incrementally search marked files for regexp"))
1667 (define-key map [menu-bar operate isearch]
1668 '(menu-item "Isearch Files..." dired-do-isearch
1669 :help "Incrementally search marked files for string"))
3e1fb00f 1670 (define-key map [menu-bar operate chown]
d066de8e
EZ
1671 '(menu-item "Change Owner..." dired-do-chown
1672 :visible (not (memq system-type '(ms-dos windows-nt)))
1673 :help "Change the owner of marked files"))
3e1fb00f 1674 (define-key map [menu-bar operate chgrp]
d066de8e
EZ
1675 '(menu-item "Change Group..." dired-do-chgrp
1676 :visible (not (memq system-type '(ms-dos windows-nt)))
1677 :help "Change the group of marked files"))
3e1fb00f 1678 (define-key map [menu-bar operate chmod]
d066de8e
EZ
1679 '(menu-item "Change Mode..." dired-do-chmod
1680 :help "Change mode (attributes) of marked files"))
57654b8c
JL
1681 (define-key map [menu-bar operate touch]
1682 '(menu-item "Change Timestamp..." dired-do-touch
1683 :help "Change timestamp of marked files"))
3e1fb00f 1684 (define-key map [menu-bar operate load]
d066de8e
EZ
1685 '(menu-item "Load" dired-do-load
1686 :help "Load marked Emacs Lisp files"))
3e1fb00f 1687 (define-key map [menu-bar operate compile]
d066de8e
EZ
1688 '(menu-item "Byte-compile" dired-do-byte-compile
1689 :help "Byte-compile marked Emacs Lisp files"))
3e1fb00f 1690 (define-key map [menu-bar operate compress]
d066de8e
EZ
1691 '(menu-item "Compress" dired-do-compress
1692 :help "Compress/uncompress marked files"))
3e1fb00f 1693 (define-key map [menu-bar operate print]
d066de8e
EZ
1694 '(menu-item "Print..." dired-do-print
1695 :help "Ask for print command and print marked files"))
3e1fb00f 1696 (define-key map [menu-bar operate hardlink]
d066de8e
EZ
1697 '(menu-item "Hardlink to..." dired-do-hardlink
1698 :help "Make hard links for current or marked files"))
3e1fb00f 1699 (define-key map [menu-bar operate symlink]
d066de8e
EZ
1700 '(menu-item "Symlink to..." dired-do-symlink
1701 :visible (fboundp 'make-symbolic-link)
1702 :help "Make symbolic links for current or marked files"))
077bf69b
GM
1703 (define-key map [menu-bar operate async-command]
1704 '(menu-item "Asynchronous Shell Command..." dired-do-async-shell-command
1705 :help "Run a shell command asynchronously on current or marked files"))
3e1fb00f 1706 (define-key map [menu-bar operate command]
d066de8e 1707 '(menu-item "Shell Command..." dired-do-shell-command
077bf69b 1708 :help "Run a shell command on current or marked files"))
3e1fb00f 1709 (define-key map [menu-bar operate delete]
d066de8e
EZ
1710 '(menu-item "Delete" dired-do-delete
1711 :help "Delete current file or all marked files"))
3e1fb00f 1712 (define-key map [menu-bar operate rename]
d066de8e
EZ
1713 '(menu-item "Rename to..." dired-do-rename
1714 :help "Rename current file or move marked files"))
3e1fb00f 1715 (define-key map [menu-bar operate copy]
d066de8e
EZ
1716 '(menu-item "Copy to..." dired-do-copy
1717 :help "Copy current file or all marked files"))
3e1fb00f 1718
d7aed37c
SM
1719 map)
1720 "Local keymap for `dired-mode' buffers.")
83fadedf 1721\f
84fc2cfa
ER
1722;; Dired mode is suitable only for specially formatted data.
1723(put 'dired-mode 'mode-class 'special)
1724
a515788d
LH
1725;; Autoload cookie needed by desktop.el
1726;;;###autoload
492d2437
RS
1727(defun dired-mode (&optional dirname switches)
1728 "\
1729Mode for \"editing\" directory listings.
68d2f12f 1730In Dired, you are \"editing\" a list of the files in a directory and
492d2437
RS
1731 \(optionally) its subdirectories, in the format of `ls -lR'.
1732 Each directory is a page: use \\[backward-page] and \\[forward-page] to move pagewise.
1733\"Editing\" means that you can run shell commands on files, visit,
1734 compress, load or byte-compile them, change their file attributes
1735 and insert subdirectories into the same buffer. You can \"mark\"
1736 files for later commands or \"flag\" them for deletion, either file
1737 by file or all files matching certain criteria.
1738You can move using the usual cursor motion commands.\\<dired-mode-map>
1739Letters no longer insert themselves. Digits are prefix arguments.
1740Instead, type \\[dired-flag-file-deletion] to flag a file for Deletion.
1741Type \\[dired-mark] to Mark a file or subdirectory for later commands.
1742 Most commands operate on the marked files and use the current file
1743 if no files are marked. Use a numeric prefix argument to operate on
1744 the next ARG (or previous -ARG if ARG<0) files, or just `1'
1745 to operate on the current file only. Prefix arguments override marks.
1746 Mark-using commands display a list of failures afterwards. Type \\[dired-summary]
1747 to see why something went wrong.
1748Type \\[dired-unmark] to Unmark a file or all files of a subdirectory.
1749Type \\[dired-unmark-backward] to back up one line and unflag.
1750Type \\[dired-do-flagged-delete] to eXecute the deletions requested.
8cb95edf 1751Type \\[dired-find-file] to Find the current line's file
492d2437
RS
1752 (or dired it in another buffer, if it is a directory).
1753Type \\[dired-find-file-other-window] to find file or dired directory in Other window.
1754Type \\[dired-maybe-insert-subdir] to Insert a subdirectory in this buffer.
1755Type \\[dired-do-rename] to Rename a file or move the marked files to another directory.
1756Type \\[dired-do-copy] to Copy files.
ee680b2b
JB
1757Type \\[dired-sort-toggle-or-edit] to toggle Sorting by name/date or change the `ls' switches.
1758Type \\[revert-buffer] to read all currently expanded directories aGain.
492d2437
RS
1759 This retains all marks and hides subdirs again that were hidden before.
1760SPC and DEL can be used to move down and up by lines.
1761
ee680b2b 1762If Dired ever gets confused, you can either type \\[revert-buffer] \
492d2437
RS
1763to read the
1764directories again, type \\[dired-do-redisplay] \
1765to relist a single or the marked files or a
1766subdirectory, or type \\[dired-build-subdir-alist] to parse the buffer
1767again for the directory tree.
1768
1769Customization variables (rename this buffer and type \\[describe-variable] on each line
1770for more info):
1771
87ae59e3
SM
1772 `dired-listing-switches'
1773 `dired-trivial-filenames'
1774 `dired-shrink-to-fit'
1775 `dired-marker-char'
1776 `dired-del-marker'
1777 `dired-keep-marker-rename'
1778 `dired-keep-marker-copy'
1779 `dired-keep-marker-hardlink'
1780 `dired-keep-marker-symlink'
492d2437
RS
1781
1782Hooks (use \\[describe-variable] to see their documentation):
1783
87ae59e3
SM
1784 `dired-before-readin-hook'
1785 `dired-after-readin-hook'
1786 `dired-mode-hook'
1787 `dired-load-hook'
492d2437
RS
1788
1789Keybindings:
84fc2cfa 1790\\{dired-mode-map}"
492d2437
RS
1791 ;; Not to be called interactively (e.g. dired-directory will be set
1792 ;; to default-directory, which is wrong with wildcards).
84fc2cfa 1793 (kill-all-local-variables)
84fc2cfa 1794 (use-local-map dired-mode-map)
492d2437
RS
1795 (dired-advertise) ; default-directory is already set
1796 (setq major-mode 'dired-mode
1797 mode-name "Dired"
87ae59e3 1798 ;; case-fold-search nil
492d2437
RS
1799 buffer-read-only t
1800 selective-display t ; for subdirectory hiding
0acdf642
GM
1801 mode-line-buffer-identification
1802 (propertized-buffer-identification "%17b"))
492d2437
RS
1803 (set (make-local-variable 'revert-buffer-function)
1804 (function dired-revert))
573e4d2d
LT
1805 (set (make-local-variable 'buffer-stale-function)
1806 (function dired-buffer-stale-p))
492d2437
RS
1807 (set (make-local-variable 'page-delimiter)
1808 "\n\n")
1809 (set (make-local-variable 'dired-directory)
1810 (or dirname default-directory))
1811 ;; list-buffers uses this to display the dir being edited in this buffer.
11ee8d90
JB
1812 (setq list-buffers-directory
1813 (expand-file-name (if (listp dired-directory)
1814 (car dired-directory)
1815 dired-directory)))
492d2437
RS
1816 (set (make-local-variable 'dired-actual-switches)
1817 (or switches dired-listing-switches))
d7aed37c
SM
1818 (set (make-local-variable 'font-lock-defaults)
1819 '(dired-font-lock-keywords t nil nil beginning-of-line))
cb5f1f67 1820 (set (make-local-variable 'desktop-save-buffer)
31b4c848 1821 'dired-desktop-buffer-misc-data)
5553077c 1822 (setq dired-switches-alist nil)
492d2437 1823 (dired-sort-other dired-actual-switches t)
361eee8f 1824 (when (featurep 'dnd)
6ae53dc1
RS
1825 (set (make-local-variable 'dnd-protocol-alist)
1826 (append dired-dnd-protocol-alist dnd-protocol-alist)))
7d371eac 1827 (add-hook 'file-name-at-point-functions 'dired-file-name-at-point nil t)
eae2c85e 1828 (add-hook 'isearch-mode-hook 'dired-isearch-filenames-setup nil t)
1ed8284d 1829 (run-mode-hooks 'dired-mode-hook))
83fadedf 1830\f
eb8c3be9 1831;; Idiosyncratic dired commands that don't deal with marks.
84fc2cfa 1832
84fc2cfa 1833(defun dired-summary ()
ee680b2b 1834 "Summarize basic Dired commands and show recent dired errors."
84fc2cfa 1835 (interactive)
492d2437 1836 (dired-why)
84fc2cfa
ER
1837 ;>> this should check the key-bindings and use substitute-command-keys if non-standard
1838 (message
50f74744 1839 "d-elete, u-ndelete, x-punge, f-ind, o-ther window, R-ename, C-opy, h-elp"))
84fc2cfa 1840
492d2437
RS
1841(defun dired-undo ()
1842 "Undo in a dired buffer.
1843This doesn't recover lost files, it just undoes changes in the buffer itself.
487327a9 1844You can use it to recover marks, killed lines or subdirs."
492d2437 1845 (interactive)
f836b98e 1846 (let ((inhibit-read-only t))
487327a9
LT
1847 (undo))
1848 (dired-build-subdir-alist)
ee680b2b 1849 (message "Change in dired buffer undone.
487327a9 1850Actual changes in files cannot be undone by Emacs."))
84fc2cfa 1851
40aa8257
JL
1852(defun dired-toggle-read-only ()
1853 "Edit dired buffer with Wdired, or set it read-only.
1854Call `wdired-change-to-wdired-mode' in dired buffers whose editing is
1855supported by Wdired (the major mode of the dired buffer is `dired-mode').
1856Otherwise, for buffers inheriting from dired-mode, call `toggle-read-only'."
1857 (interactive)
1858 (if (eq major-mode 'dired-mode)
1859 (wdired-change-to-wdired-mode)
1860 (toggle-read-only)))
1861
84fc2cfa
ER
1862(defun dired-next-line (arg)
1863 "Move down lines then position at filename.
1864Optional prefix ARG says how many lines to move; default is one line."
1865 (interactive "p")
e82a724f 1866 (forward-line arg)
84fc2cfa
ER
1867 (dired-move-to-filename))
1868
1869(defun dired-previous-line (arg)
1870 "Move up lines then position at filename.
1871Optional prefix ARG says how many lines to move; default is one line."
1872 (interactive "p")
e82a724f 1873 (forward-line (- arg))
84fc2cfa
ER
1874 (dired-move-to-filename))
1875
492d2437
RS
1876(defun dired-next-dirline (arg &optional opoint)
1877 "Goto ARG'th next directory file line."
1878 (interactive "p")
1879 (or opoint (setq opoint (point)))
1880 (if (if (> arg 0)
1881 (re-search-forward dired-re-dir nil t arg)
1882 (beginning-of-line)
1883 (re-search-backward dired-re-dir nil t (- arg)))
1884 (dired-move-to-filename) ; user may type `i' or `f'
1885 (goto-char opoint)
1886 (error "No more subdirectories")))
1887
1888(defun dired-prev-dirline (arg)
1889 "Goto ARG'th previous directory file line."
1890 (interactive "p")
1891 (dired-next-dirline (- arg)))
1892
ac1ce341 1893(defun dired-up-directory (&optional other-window)
68d2f12f 1894 "Run Dired on parent directory of current directory.
492d2437
RS
1895Find the parent directory either in this buffer or another buffer.
1896Creates a buffer if necessary."
ac1ce341 1897 (interactive "P")
492d2437
RS
1898 (let* ((dir (dired-current-directory))
1899 (up (file-name-directory (directory-file-name dir))))
1900 (or (dired-goto-file (directory-file-name dir))
7b2469ae
RS
1901 ;; Only try dired-goto-subdir if buffer has more than one dir.
1902 (and (cdr dired-subdir-alist)
492d2437
RS
1903 (dired-goto-subdir up))
1904 (progn
ac1ce341
EN
1905 (if other-window
1906 (dired-other-window up)
1907 (dired up))
492d2437 1908 (dired-goto-file dir)))))
84fc2cfa 1909
68d2f12f
RS
1910(defun dired-get-file-for-visit ()
1911 "Get the current line's file name, with an error if file does not exist."
53fd9d05 1912 (interactive)
e9407052
RS
1913 ;; We pass t for second arg so that we don't get error for `.' and `..'.
1914 (let ((raw (dired-get-filename nil t))
1915 file-name)
1916 (if (null raw)
1917 (error "No file on this line"))
1918 (setq file-name (file-name-sans-versions raw t))
c439687b 1919 (if (file-exists-p file-name)
68d2f12f 1920 file-name
55642aa4
RS
1921 (if (file-symlink-p file-name)
1922 (error "File is a symlink to a nonexistent target")
ee680b2b 1923 (error "File no longer exists; type `g' to update dired buffer")))))
84fc2cfa 1924
f143d380 1925;; Force C-m keybinding rather than `f' or `e' in the mode doc:
8cb95edf 1926(define-obsolete-function-alias 'dired-advertised-find-file 'dired-find-file "23.2")
68d2f12f
RS
1927(defun dired-find-file ()
1928 "In Dired, visit the file or directory named on this line."
1929 (interactive)
1d5ad120 1930 ;; Bind `find-file-run-dired' so that the command works on directories
59d18288
RS
1931 ;; too, independent of the user's setting.
1932 (let ((find-file-run-dired t))
1933 (find-file (dired-get-file-for-visit))))
68d2f12f 1934
c5753a5d 1935(defun dired-find-alternate-file ()
68d2f12f 1936 "In Dired, visit this file or directory instead of the dired buffer."
c5753a5d
GM
1937 (interactive)
1938 (set-buffer-modified-p nil)
68d2f12f 1939 (find-alternate-file (dired-get-file-for-visit)))
336cd99d 1940;; Don't override the setting from .emacs.
c21993d0 1941;;;###autoload (put 'dired-find-alternate-file 'disabled t)
c5753a5d 1942
dbcb9389 1943(defun dired-mouse-find-file-other-window (event)
68d2f12f 1944 "In Dired, visit the file or directory name you click on."
dbcb9389 1945 (interactive "e")
2aaa7f0a 1946 (let (window pos file)
dbcb9389 1947 (save-excursion
2aaa7f0a
RS
1948 (setq window (posn-window (event-end event))
1949 pos (posn-point (event-end event)))
1950 (if (not (windowp window))
1951 (error "No file chosen"))
1952 (set-buffer (window-buffer window))
1953 (goto-char pos)
1954 (setq file (dired-get-file-for-visit)))
55a87770
RS
1955 (if (file-directory-p file)
1956 (or (and (cdr dired-subdir-alist)
1957 (dired-goto-subdir file))
1958 (progn
1959 (select-window window)
1960 (dired-other-window file)))
3f68d7c8
RS
1961 (select-window window)
1962 (find-file-other-window (file-name-sans-versions file t)))))
b70ebe37 1963
84fc2cfa 1964(defun dired-view-file ()
ee680b2b 1965 "In Dired, examine a file in view mode, returning to Dired when done.
b70ebe37 1966When file is a directory, show it in this buffer if it is inserted.
3f68d7c8 1967Otherwise, display it in another buffer."
84fc2cfa 1968 (interactive)
68d2f12f
RS
1969 (let ((file (dired-get-file-for-visit)))
1970 (if (file-directory-p file)
1971 (or (and (cdr dired-subdir-alist)
1972 (dired-goto-subdir file))
1973 (dired file))
3f68d7c8 1974 (view-file file))))
84fc2cfa
ER
1975
1976(defun dired-find-file-other-window ()
68d2f12f 1977 "In Dired, visit this file or directory in another window."
84fc2cfa 1978 (interactive)
68d2f12f 1979 (find-file-other-window (dired-get-file-for-visit)))
ab67260b
RS
1980
1981(defun dired-display-file ()
68d2f12f 1982 "In Dired, display this file or directory in another window."
ab67260b 1983 (interactive)
68d2f12f 1984 (display-buffer (find-file-noselect (dired-get-file-for-visit))))
83fadedf 1985\f
68d2f12f 1986;;; Functions for extracting and manipulating file names in Dired buffers.
84fc2cfa
ER
1987
1988(defun dired-get-filename (&optional localp no-error-if-not-filep)
68d2f12f 1989 "In Dired, return name of file mentioned on this line.
84fc2cfa 1990Value returned normally includes the directory name.
492d2437 1991Optional arg LOCALP with value `no-dir' means don't include directory
147e214c
LT
1992name in result. A value of `verbatim' means to return the name exactly as
1993it occurs in the buffer, and a value of t means construct name relative to
1994`default-directory', which still may contain slashes if in a subdirectory.
1995Optional arg NO-ERROR-IF-NOT-FILEP means treat `.' and `..' as
1996regular filenames and return nil if no filename on this line.
1997Otherwise, an error occurs in these cases."
a5e0e1a8 1998 (let (case-fold-search file p1 p2 already-absolute)
84fc2cfa 1999 (save-excursion
492d2437
RS
2000 (if (setq p1 (dired-move-to-filename (not no-error-if-not-filep)))
2001 (setq p2 (dired-move-to-end-of-filename no-error-if-not-filep))))
2002 ;; nil if no file on this line, but no-error-if-not-filep is t:
9888aa65
RS
2003 (if (setq file (and p1 p2 (buffer-substring p1 p2)))
2004 (progn
2005 ;; Get rid of the mouse-face property that file names have.
2006 (set-text-properties 0 (length file) nil file)
2007 ;; Unquote names quoted by ls or by dired-insert-directory.
1be9bd1e
CY
2008 ;; This code was written using `read' to unquote, because
2009 ;; it's faster than substituting \007 (4 chars) -> ^G (1
2010 ;; char) etc. in a lisp loop. Unfortunately, this decision
2011 ;; has necessitated hacks such as dealing with filenames
2012 ;; with quotation marks in their names.
2013 (while (string-match "\\(?:[^\\]\\|\\`\\)\\(\"\\)" file)
2014 (setq file (replace-match "\\\"" nil t file 1)))
2015 (setq file (read (concat "\"" file "\"")))
038b5501
KH
2016 ;; The above `read' will return a unibyte string if FILE
2017 ;; contains eight-bit-control/graphic characters.
2018 (if (and enable-multibyte-characters
2019 (not (multibyte-string-p file)))
2020 (setq file (string-to-multibyte file)))))
f6e2cbe3 2021 (and file (file-name-absolute-p file)
7994d91a
RS
2022 ;; A relative file name can start with ~.
2023 ;; Don't treat it as absolute in this context.
2024 (not (eq (aref file 0) ?~))
a5e0e1a8 2025 (setq already-absolute t))
a5e0e1a8 2026 (cond
b95ddab3
RS
2027 ((null file)
2028 nil)
1d5ad120
JB
2029 ((eq localp 'verbatim)
2030 file)
e9407052 2031 ((and (not no-error-if-not-filep)
5709c1a0 2032 (member file '("." "..")))
e9407052 2033 (error "Cannot operate on `.' or `..'"))
a5e0e1a8
EZ
2034 ((and (eq localp 'no-dir) already-absolute)
2035 (file-name-nondirectory file))
b95ddab3 2036 (already-absolute
ca66efd1
RS
2037 (let ((handler (find-file-name-handler file nil)))
2038 ;; check for safe-magic property so that we won't
2039 ;; put /: for names that don't really need them.
0b7bc76f 2040 ;; For instance, .gz files when auto-compression-mode is on.
ca66efd1
RS
2041 (if (and handler (not (get handler 'safe-magic)))
2042 (concat "/:" file)
2043 file)))
b95ddab3 2044 ((eq localp 'no-dir)
a5e0e1a8 2045 file)
b95ddab3
RS
2046 ((equal (dired-current-directory) "/")
2047 (setq file (concat (dired-current-directory localp) file))
ca66efd1
RS
2048 (let ((handler (find-file-name-handler file nil)))
2049 ;; check for safe-magic property so that we won't
2050 ;; put /: for names that don't really need them.
2051 ;; For instance, .gz files when auto-compression-mode is on.
2052 (if (and handler (not (get handler 'safe-magic)))
2053 (concat "/:" file)
2054 file)))
a5e0e1a8 2055 (t
b95ddab3 2056 (concat (dired-current-directory localp) file)))))
492d2437 2057
437fe5ae 2058(defun dired-string-replace-match (regexp string newtext
1d5ad120 2059 &optional literal global)
437fe5ae
RS
2060 "Replace first match of REGEXP in STRING with NEWTEXT.
2061If it does not match, nil is returned instead of the new string.
2062Optional arg LITERAL means to take NEWTEXT literally.
2063Optional arg GLOBAL means to replace all matches."
2064 (if global
b976e099 2065 (let ((start 0) ret)
856321e2
RS
2066 (while (string-match regexp string start)
2067 (let ((from-end (- (length string) (match-end 0))))
b976e099 2068 (setq ret (setq string (replace-match newtext t literal string)))
856321e2 2069 (setq start (- (length string) from-end))))
b976e099 2070 ret)
437fe5ae
RS
2071 (if (not (string-match regexp string 0))
2072 nil
856321e2 2073 (replace-match newtext t literal string))))
437fe5ae 2074
492d2437 2075(defun dired-make-absolute (file &optional dir)
470fa6d1 2076 ;;"Convert FILE (a file name relative to DIR) to an absolute file name."
492d2437
RS
2077 ;; We can't always use expand-file-name as this would get rid of `.'
2078 ;; or expand in / instead default-directory if DIR=="".
7c2fb837 2079 ;; This should be good enough for ange-ftp.
492d2437
RS
2080 ;; It should be reasonably fast, though, as it is called in
2081 ;; dired-get-filename.
2082 (concat (or dir default-directory) file))
2083
827dc60d
RS
2084(defun dired-make-relative (file &optional dir ignore)
2085 "Convert FILE (an absolute file name) to a name relative to DIR.
2086If this is impossible, return FILE unchanged.
2087DIR must be a directory name, not a file name."
492d2437 2088 (or dir (setq dir default-directory))
7425bbff
RS
2089 ;; This case comes into play if default-directory is set to
2090 ;; use ~.
2091 (if (and (> (length dir) 0) (= (aref dir 0) ?~))
2092 (setq dir (expand-file-name dir)))
492d2437
RS
2093 (if (string-match (concat "^" (regexp-quote dir)) file)
2094 (substring file (match-end 0))
7805cdbd 2095;;; (or no-error
827dc60d
RS
2096;;; (error "%s: not in directory tree growing at %s" file dir))
2097 file))
83fadedf 2098\f
492d2437
RS
2099;;; Functions for finding the file name in a dired buffer line.
2100
23e217f6
RS
2101(defvar dired-permission-flags-regexp
2102 "\\([^ ]\\)[-r][-w]\\([^ ]\\)[-r][-w]\\([^ ]\\)[-r][-w]\\([^ ]\\)"
2103 "Regular expression to match the permission flags in `ls -l'.")
2104
492d2437
RS
2105;; Move to first char of filename on this line.
2106;; Returns position (point) or nil if no filename on this line."
2107(defun dired-move-to-filename (&optional raise-error eol)
a12c6dca
SM
2108 "Move to the beginning of the filename on the current line.
2109Return the position of the beginning of the filename, or nil if none found."
492d2437 2110 ;; This is the UNIX version.
2b2059d8 2111 (or eol (setq eol (line-end-position)))
492d2437 2112 (beginning-of-line)
0b7bc76f 2113 ;; First try assuming `ls --dired' was used.
2b2059d8
SM
2114 (let ((change (next-single-property-change (point) 'dired-filename nil eol)))
2115 (cond
2116 ((and change (< change eol))
2117 (goto-char change))
9bc260cf 2118 ((re-search-forward directory-listing-before-filename-regexp eol t)
2b2059d8
SM
2119 (goto-char (match-end 0)))
2120 ((re-search-forward dired-permission-flags-regexp eol t)
2121 ;; Ha! There *is* a file. Our regexp-from-hell just failed to find it.
1f3b4d04 2122 (if raise-error
9bc260cf 2123 (error "Unrecognized line! Check directory-listing-before-filename-regexp"))
1f3b4d04
SM
2124 (beginning-of-line)
2125 nil)
2b2059d8
SM
2126 (raise-error
2127 (error "No file on this line")))))
492d2437
RS
2128
2129(defun dired-move-to-end-of-filename (&optional no-error)
2130 ;; Assumes point is at beginning of filename,
2131 ;; thus the rwx bit re-search-backward below will succeed in *this*
2132 ;; line if at all. So, it should be called only after
2133 ;; (dired-move-to-filename t).
2134 ;; On failure, signals an error (with non-nil NO-ERROR just returns nil).
2135 ;; This is the UNIX version.
0b7bc76f
RS
2136 (if (get-text-property (point) 'dired-filename)
2137 (goto-char (next-single-property-change (point) 'dired-filename))
2138 (let (opoint file-type executable symlink hidden case-fold-search used-F eol)
2139 ;; case-fold-search is nil now, so we can test for capital F:
2140 (setq used-F (string-match "F" dired-actual-switches)
2141 opoint (point)
2142 eol (save-excursion (end-of-line) (point))
2143 hidden (and selective-display
2144 (save-excursion (search-forward "\r" eol t))))
2145 (if hidden
2146 nil
2147 (save-excursion ;; Find out what kind of file this is:
2148 ;; Restrict perm bits to be non-blank,
2149 ;; otherwise this matches one char to early (looking backward):
2150 ;; "l---------" (some systems make symlinks that way)
2151 ;; "----------" (plain file with zero perms)
2152 (if (re-search-backward
2153 dired-permission-flags-regexp nil t)
2154 (setq file-type (char-after (match-beginning 1))
2155 symlink (eq file-type ?l)
2156 ;; Only with -F we need to know whether it's an executable
2157 executable (and
2158 used-F
2159 (string-match
2160 "[xst]" ;; execute bit set anywhere?
2161 (concat
ff3d76aa
SM
2162 (match-string 2)
2163 (match-string 3)
2164 (match-string 4)))))
0b7bc76f
RS
2165 (or no-error (error "No file on this line"))))
2166 ;; Move point to end of name:
2167 (if symlink
a12c6dca 2168 (if (search-forward " -> " eol t)
0b7bc76f 2169 (progn
a12c6dca 2170 (forward-char -4)
0b7bc76f
RS
2171 (and used-F
2172 dired-ls-F-marks-symlinks
2173 (eq (preceding-char) ?@) ;; did ls really mark the link?
2174 (forward-char -1))))
2175 (goto-char eol) ;; else not a symbolic link
dd52fff6
TTN
2176 ;; ls -lF marks dirs, sockets, fifos and executables with exactly
2177 ;; one trailing character. (Executable bits on symlinks ain't mean
0b7bc76f
RS
2178 ;; a thing, even to ls, but we know it's not a symlink.)
2179 (and used-F
dd52fff6 2180 (or (memq file-type '(?d ?s ?p))
0b7bc76f
RS
2181 executable)
2182 (forward-char -1))))
2183 (or no-error
2184 (not (eq opoint (point)))
8c16bd8c 2185 (error "%s" (if hidden
0b7bc76f
RS
2186 (substitute-command-keys
2187 "File line is hidden, type \\[dired-hide-subdir] to unhide")
2188 "No file on this line")))
2189 (if (eq opoint (point))
2190 nil
2191 (point)))))
492d2437 2192
83fadedf 2193\f
a3f4a3ef
RS
2194;;; COPY NAMES OF MARKED FILES INTO KILL-RING.
2195
2196(defun dired-copy-filename-as-kill (&optional arg)
2197 "Copy names of marked (or next ARG) files into the kill ring.
2198The names are separated by a space.
470fa6d1 2199With a zero prefix arg, use the absolute file name of each marked file.
ee680b2b 2200With \\[universal-argument], use the file name relative to the dired buffer's
afda9919 2201`default-directory'. (This still may contain slashes if in a subdirectory.)
a3f4a3ef 2202
afda9919
LT
2203If on a subdir headerline, use absolute subdirname instead;
2204prefix arg and marked files are ignored in this case.
a3f4a3ef
RS
2205
2206You can then feed the file name(s) to other commands with \\[yank]."
2207 (interactive "P")
2208 (let ((string
2209 (or (dired-get-subdir)
2210 (mapconcat (function identity)
2211 (if arg
2212 (cond ((zerop (prefix-numeric-value arg))
2213 (dired-get-marked-files))
afda9919
LT
2214 ((consp arg)
2215 (dired-get-marked-files t))
2216 (t
2217 (dired-get-marked-files
2218 'no-dir (prefix-numeric-value arg))))
a3f4a3ef
RS
2219 (dired-get-marked-files 'no-dir))
2220 " "))))
4de547e4
RS
2221 (if (eq last-command 'kill-region)
2222 (kill-append string nil)
2223 (kill-new string))
a3f4a3ef
RS
2224 (message "%s" string)))
2225
2226\f
492d2437
RS
2227;; Keeping Dired buffers in sync with the filesystem and with each other
2228
ef746164 2229(defun dired-buffers-for-dir (dir &optional file)
492d2437 2230;; Return a list of buffers that dired DIR (top level or in-situ subdir).
ef746164
RS
2231;; If FILE is non-nil, include only those whose wildcard pattern (if any)
2232;; matches FILE.
492d2437
RS
2233;; The list is in reverse order of buffer creation, most recent last.
2234;; As a side effect, killed dired buffers for DIR are removed from
2235;; dired-buffers.
2236 (setq dir (file-name-as-directory dir))
a12c6dca 2237 (let ((alist dired-buffers) result elt buf)
492d2437 2238 (while alist
38819778
RS
2239 (setq elt (car alist)
2240 buf (cdr elt))
2241 (if (buffer-name buf)
2242 (if (dired-in-this-tree dir (car elt))
ef746164
RS
2243 (with-current-buffer buf
2244 (and (assoc dir dired-subdir-alist)
2245 (or (null file)
2246 (let ((wildcards
2247 (file-name-nondirectory dired-directory)))
2248 (or (= 0 (length wildcards))
2249 (string-match (dired-glob-regexp wildcards)
2250 file))))
2251 (setq result (cons buf result)))))
38819778
RS
2252 ;; else buffer is killed - clean up:
2253 (setq dired-buffers (delq elt dired-buffers)))
492d2437
RS
2254 (setq alist (cdr alist)))
2255 result))
2256
ef746164
RS
2257(defun dired-glob-regexp (pattern)
2258 "Convert glob-pattern PATTERN to a regular expression."
2259 (let ((matched-in-pattern 0) ;; How many chars of PATTERN we've handled.
2260 regexp)
2261 (while (string-match "[[?*]" pattern matched-in-pattern)
2262 (let ((op-end (match-end 0))
2263 (next-op (aref pattern (match-beginning 0))))
2264 (setq regexp (concat regexp
2265 (regexp-quote
2266 (substring pattern matched-in-pattern
2267 (match-beginning 0)))))
2268 (cond ((= next-op ??)
2269 (setq regexp (concat regexp "."))
2270 (setq matched-in-pattern op-end))
2271 ((= next-op ?\[)
2272 ;; Fails to handle ^ yet ????
2273 (let* ((set-start (match-beginning 0))
2274 (set-cont
2275 (if (= (aref pattern (1+ set-start)) ?^)
2276 (+ 3 set-start)
2277 (+ 2 set-start)))
2278 (set-end (string-match "]" pattern set-cont))
2279 (set (substring pattern set-start (1+ set-end))))
2280 (setq regexp (concat regexp set))
2281 (setq matched-in-pattern (1+ set-end))))
2282 ((= next-op ?*)
2283 (setq regexp (concat regexp ".*"))
2284 (setq matched-in-pattern op-end)))))
2285 (concat "\\`"
2286 regexp
2287 (regexp-quote
2288 (substring pattern matched-in-pattern))
2289 "\\'")))
2290
c60ee5e7 2291
ef746164 2292
492d2437
RS
2293(defun dired-advertise ()
2294 ;;"Advertise in variable `dired-buffers' that we dired `default-directory'."
2295 ;; With wildcards we actually advertise too much.
38819778
RS
2296 (let ((expanded-default (expand-file-name default-directory)))
2297 (if (memq (current-buffer) (dired-buffers-for-dir expanded-default))
2298 t ; we have already advertised ourselves
2299 (setq dired-buffers
2300 (cons (cons expanded-default (current-buffer))
2301 dired-buffers)))))
492d2437
RS
2302
2303(defun dired-unadvertise (dir)
2304 ;; Remove DIR from the buffer alist in variable dired-buffers.
2305 ;; This has the effect of removing any buffer whose main directory is DIR.
2306 ;; It does not affect buffers in which DIR is a subdir.
2307 ;; Removing is also done as a side-effect in dired-buffer-for-dir.
2308 (setq dired-buffers
38819778 2309 (delq (assoc (expand-file-name dir) dired-buffers) dired-buffers)))
83fadedf 2310\f
492d2437
RS
2311;; Tree Dired
2312
2313;;; utility functions
2314
2315(defun dired-in-this-tree (file dir)
2316 ;;"Is FILE part of the directory tree starting at DIR?"
2317 (let (case-fold-search)
38819778 2318 (string-match (concat "^" (regexp-quote dir)) file)))
492d2437
RS
2319
2320(defun dired-normalize-subdir (dir)
470fa6d1
KS
2321 ;; Prepend default-directory to DIR if relative file name.
2322 ;; dired-get-filename must be able to make a valid file name from a
492d2437
RS
2323 ;; file and its directory DIR.
2324 (file-name-as-directory
2325 (if (file-name-absolute-p dir)
2326 dir
2327 (expand-file-name dir default-directory))))
2328
2329(defun dired-get-subdir ()
2330 ;;"Return the subdir name on this line, or nil if not on a headerline."
2331 ;; Look up in the alist whether this is a headerline.
2332 (save-excursion
2333 (let ((cur-dir (dired-current-directory)))
2334 (beginning-of-line) ; alist stores b-o-l positions
2335 (and (zerop (- (point)
2336 (dired-get-subdir-min (assoc cur-dir
2337 dired-subdir-alist))))
2338 cur-dir))))
2339
2340;(defun dired-get-subdir-min (elt)
2341; (cdr elt))
2342;; can't use macro, must be redefinable for other alist format in dired-nstd.
62f61df0 2343(defalias 'dired-get-subdir-min 'cdr)
492d2437
RS
2344
2345(defun dired-get-subdir-max (elt)
84fc2cfa 2346 (save-excursion
492d2437
RS
2347 (goto-char (dired-get-subdir-min elt))
2348 (dired-subdir-max)))
2349
2350(defun dired-clear-alist ()
2351 (while dired-subdir-alist
2352 (set-marker (dired-get-subdir-min (car dired-subdir-alist)) nil)
2353 (setq dired-subdir-alist (cdr dired-subdir-alist))))
2354
c9d59fc2
RS
2355(defun dired-subdir-index (dir)
2356 ;; Return an index into alist for use with nth
2357 ;; for the sake of subdir moving commands.
2358 (let (found (index 0) (alist dired-subdir-alist))
2359 (while alist
2360 (if (string= dir (car (car alist)))
2361 (setq alist nil found t)
2362 (setq alist (cdr alist) index (1+ index))))
2363 (if found index nil)))
2364
2365(defun dired-next-subdir (arg &optional no-error-if-not-found no-skip)
2366 "Go to next subdirectory, regardless of level."
2367 ;; Use 0 arg to go to this directory's header line.
2368 ;; NO-SKIP prevents moving to end of header line, returning whatever
2369 ;; position was found in dired-subdir-alist.
2370 (interactive "p")
2371 (let ((this-dir (dired-current-directory))
2372 pos index)
2373 ;; nth with negative arg does not return nil but the first element
2374 (setq index (- (dired-subdir-index this-dir) arg))
2375 (setq pos (if (>= index 0)
2376 (dired-get-subdir-min (nth index dired-subdir-alist))))
2377 (if pos
2378 (progn
2379 (goto-char pos)
2380 (or no-skip (skip-chars-forward "^\n\r"))
2381 (point))
2382 (if no-error-if-not-found
2383 nil ; return nil if not found
2384 (error "%s directory" (if (> arg 0) "Last" "First"))))))
2385
3c13627a 2386(defun dired-build-subdir-alist (&optional switches)
492d2437 2387 "Build `dired-subdir-alist' by parsing the buffer.
3c13627a
EZ
2388Returns the new value of the alist.
2389If optional arg SWITCHES is non-nil, use its value
2390instead of `dired-actual-switches'."
492d2437
RS
2391 (interactive)
2392 (dired-clear-alist)
2393 (save-excursion
3c13627a 2394 (let* ((count 0)
f836b98e 2395 (inhibit-read-only t)
784a48b2 2396 (buffer-undo-list t)
3c13627a
EZ
2397 (switches (or switches dired-actual-switches))
2398 new-dir-name
2399 (R-ftp-base-dir-regex
2400 ;; Used to expand subdirectory names correctly in recursive
2401 ;; ange-ftp listings.
2402 (and (string-match "R" switches)
2403 (string-match "\\`/.*:\\(/.*\\)" default-directory)
2404 (concat "\\`" (match-string 1 default-directory)))))
84fc2cfa 2405 (goto-char (point-min))
492d2437 2406 (setq dired-subdir-alist nil)
a3d76960
RS
2407 (while (re-search-forward dired-subdir-regexp nil t)
2408 ;; Avoid taking a file name ending in a colon
2409 ;; as a subdir name.
2410 (unless (save-excursion
2411 (goto-char (match-beginning 0))
2412 (beginning-of-line)
2413 (forward-char 2)
2414 (save-match-data (looking-at dired-re-perms)))
2415 (save-excursion
2416 (goto-char (match-beginning 1))
2417 (setq new-dir-name
2418 (buffer-substring-no-properties (point) (match-end 1))
2419 new-dir-name
2420 (save-match-data
2421 (if (and R-ftp-base-dir-regex
2422 (not (string= new-dir-name default-directory))
2423 (string-match R-ftp-base-dir-regex new-dir-name))
2424 (concat default-directory
2425 (substring new-dir-name (match-end 0)))
2426 (expand-file-name new-dir-name))))
2427 (delete-region (point) (match-end 1))
7de3f9a4
RS
2428 (insert new-dir-name))
2429 (setq count (1+ count))
2430 (dired-alist-add-1 new-dir-name
2431 ;; Place a sub directory boundary between lines.
2432 (save-excursion
2433 (goto-char (match-beginning 0))
2434 (beginning-of-line)
2435 (point-marker)))))
32226619 2436 (if (and (> count 1) (called-interactively-p 'interactive))
a3d76960
RS
2437 (message "Buffer includes %d directories" count)))
2438 ;; We don't need to sort it because it is in buffer order per
2439 ;; constructionem. Return new alist:
2440 dired-subdir-alist))
492d2437
RS
2441
2442(defun dired-alist-add-1 (dir new-marker)
2443 ;; Add new DIR at NEW-MARKER. Don't sort.
2444 (setq dired-subdir-alist
2445 (cons (cons (dired-normalize-subdir dir) new-marker)
2446 dired-subdir-alist)))
2447
2448(defun dired-goto-next-nontrivial-file ()
2449 ;; Position point on first nontrivial file after point.
2450 (dired-goto-next-file);; so there is a file to compare with
2451 (if (stringp dired-trivial-filenames)
2452 (while (and (not (eobp))
2453 (string-match dired-trivial-filenames
2454 (file-name-nondirectory
2455 (or (dired-get-filename nil t) ""))))
2456 (forward-line 1)
2457 (dired-move-to-filename))))
2458
2459(defun dired-goto-next-file ()
2460 (let ((max (1- (dired-subdir-max))))
2461 (while (and (not (dired-move-to-filename)) (< (point) max))
2462 (forward-line 1))))
2463
2464(defun dired-goto-file (file)
e19d2d64 2465 "Go to line describing file FILE in this dired buffer."
492d2437 2466 ;; Return value of point on success, else nil.
470fa6d1 2467 ;; FILE must be an absolute file name.
492d2437
RS
2468 ;; Loses if FILE contains control chars like "\007" for which ls
2469 ;; either inserts "?" or "\\007" into the buffer, so we won't find
2470 ;; it in the buffer.
2471 (interactive
2472 (prog1 ; let push-mark display its message
2473 (list (expand-file-name
2474 (read-file-name "Goto file: "
2475 (dired-current-directory))))
2476 (push-mark)))
2477 (setq file (directory-file-name file)) ; does no harm if no directory
2478 (let (found case-fold-search dir)
2479 (setq dir (or (file-name-directory file)
f808da9e 2480 (error "File name `%s' is not absolute" file)))
492d2437
RS
2481 (save-excursion
2482 ;; The hair here is to get the result of dired-goto-subdir
2483 ;; without really calling it if we don't have any subdirs.
233993a3 2484 (if (if (string= dir (expand-file-name default-directory))
492d2437 2485 (goto-char (point-min))
7b2469ae 2486 (and (cdr dired-subdir-alist)
492d2437
RS
2487 (dired-goto-subdir dir)))
2488 (let ((base (file-name-nondirectory file))
f808da9e 2489 search-string
492d2437 2490 (boundary (dired-subdir-max)))
f808da9e
RS
2491 (setq search-string
2492 (replace-regexp-in-string "\^m" "\\^m" base nil t))
2493 (setq search-string
2494 (replace-regexp-in-string "\\\\" "\\\\" search-string nil t))
492d2437
RS
2495 (while (and (not found)
2496 ;; filenames are preceded by SPC, this makes
2497 ;; the search faster (e.g. for the filename "-"!).
f808da9e
RS
2498 (search-forward (concat " " search-string)
2499 boundary 'move))
492d2437
RS
2500 ;; Match could have BASE just as initial substring or
2501 ;; or in permission bits or date or
2502 ;; not be a proper filename at all:
2503 (if (equal base (dired-get-filename 'no-dir t))
2504 ;; Must move to filename since an (actually
2505 ;; correct) match could have been elsewhere on the
2506 ;; ;; line (e.g. "-" would match somewhere in the
2507 ;; permission bits).
55e86af6
RS
2508 (setq found (dired-move-to-filename))
2509 ;; If this isn't the right line, move forward to avoid
2510 ;; trying this line again.
2511 (forward-line 1))))))
492d2437
RS
2512 (and found
2513 ;; return value of point (i.e., FOUND):
2514 (goto-char found))))
2515
2516(defun dired-initial-position (dirname)
2517 ;; Where point should go in a new listing of DIRNAME.
2518 ;; Point assumed at beginning of new subdir line.
2519 ;; You may redefine this function as you wish, e.g. like in dired-x.el.
2520 (end-of-line)
2521 (if dired-trivial-filenames (dired-goto-next-nontrivial-file)))
83fadedf 2522\f
492d2437
RS
2523;; These are hooks which make tree dired work.
2524;; They are in this file because other parts of dired need to call them.
2525;; But they don't call the rest of tree dired unless there are subdirs loaded.
2526
2527;; This function is called for each retrieved filename.
2528;; It could stand to be faster, though it's mostly function call
2529;; overhead. Avoiding the function call seems to save about 10% in
2530;; dired-get-filename. Make it a defsubst?
2531(defun dired-current-directory (&optional localp)
2532 "Return the name of the subdirectory to which this line belongs.
2533This returns a string with trailing slash, like `default-directory'.
2534Optional argument means return a file name relative to `default-directory'."
2535 (let ((here (point))
2536 (alist (or dired-subdir-alist
2537 ;; probably because called in a non-dired buffer
2538 (error "No subdir-alist in %s" (current-buffer))))
2539 elt dir)
2540 (while alist
2541 (setq elt (car alist)
2542 dir (car elt)
2543 ;; use `<=' (not `<') as subdir line is part of subdir
2544 alist (if (<= (dired-get-subdir-min elt) here)
2545 nil ; found
2546 (cdr alist))))
2547 (if localp
2548 (dired-make-relative dir default-directory)
2549 dir)))
2550
2551;; Subdirs start at the beginning of their header lines and end just
2552;; before the beginning of the next header line (or end of buffer).
2553
2554(defun dired-subdir-max ()
2555 (save-excursion
7b2469ae 2556 (if (or (null (cdr dired-subdir-alist)) (not (dired-next-subdir 1 t t)))
492d2437
RS
2557 (point-max)
2558 (point))))
83fadedf 2559\f
492d2437
RS
2560;; Deleting files
2561
40aa8257 2562(defcustom dired-recursive-deletes 'top
9201cc28 2563 "Decide whether recursive deletes are allowed.
098bab71 2564A value of nil means no recursive deletes.
f0628026
RS
2565`always' means delete recursively without asking. This is DANGEROUS!
2566`top' means ask for each directory at top level, but delete its subdirectories
2567without asking.
2568Anything else means ask for each directory."
53ade5c7
RS
2569 :type '(choice :tag "Delete non-empty directories"
2570 (const :tag "Yes" always)
2571 (const :tag "No--only delete empty directories" nil)
2572 (const :tag "Confirm for each directory" t)
2573 (const :tag "Confirm for each top directory only" top))
f0628026
RS
2574 :group 'dired)
2575
c60ee5e7 2576;; Match anything but `.' and `..'.
f0628026
RS
2577(defvar dired-re-no-dot "^\\([^.]\\|\\.\\([^.]\\|\\..\\)\\).*")
2578
2579;; Delete file, possibly delete a directory and all its files.
2580;; This function is usefull outside of dired. One could change it's name
2581;; to e.g. recursive-delete-file and put it somewhere else.
f1a5d776 2582(defun dired-delete-file (file &optional recursive trash) "\
f0628026
RS
2583Delete FILE or directory (possibly recursively if optional RECURSIVE is true.)
2584RECURSIVE determines what to do with a non-empty directory. If RECURSIVE is:
ee680b2b 2585nil, do not delete.
f0628026
RS
2586`always', delete recursively without asking.
2587`top', ask for each directory at top level.
2588Anything else, ask for each sub-directory."
56808ea0
MA
2589 ;; This test is equivalent to
2590 ;; (and (file-directory-p fn) (not (file-symlink-p fn)))
2591 ;; but more efficient
2592 (if (not (eq t (car (file-attributes file))))
f1a5d776 2593 (delete-file file trash)
56808ea0
MA
2594 (if (and recursive
2595 (directory-files file t dired-re-no-dot) ; Not empty.
2596 (or (eq recursive 'always)
f1a5d776
CY
2597 (yes-or-no-p (format "Recursively %s %s? "
2598 (if (and trash
2599 delete-by-moving-to-trash)
2600 "trash"
2601 "delete")
56808ea0 2602 (dired-make-relative file)))))
f0628026 2603 (if (eq recursive 'top) (setq recursive 'always)) ; Don't ask again.
56808ea0 2604 (setq recursive nil))
f1a5d776 2605 (delete-directory file recursive trash)))
f0628026 2606
7da0e9b4 2607(defun dired-do-flagged-delete (&optional nomessage)
68d2f12f 2608 "In Dired, delete the files flagged for deletion.
7da0e9b4 2609If NOMESSAGE is non-nil, we don't display any message
bce1acc3 2610if there are no flagged files.
40aa8257
JL
2611`dired-recursive-deletes' controls whether deletion of
2612non-empty directories is allowed."
492d2437
RS
2613 (interactive)
2614 (let* ((dired-marker-char dired-del-marker)
2615 (regexp (dired-marker-regexp))
2616 case-fold-search)
2617 (if (save-excursion (goto-char (point-min))
2618 (re-search-forward regexp nil t))
2619 (dired-internal-do-deletions
2620 ;; this can't move point since ARG is nil
2621 (dired-map-over-marks (cons (dired-get-filename) (point))
2622 nil)
f1a5d776 2623 nil t)
7da0e9b4
RS
2624 (or nomessage
2625 (message "(No deletions requested)")))))
492d2437
RS
2626
2627(defun dired-do-delete (&optional arg)
bce1acc3 2628 "Delete all marked (or next ARG) files.
40aa8257
JL
2629`dired-recursive-deletes' controls whether deletion of
2630non-empty directories is allowed."
492d2437
RS
2631 ;; This is more consistent with the file marking feature than
2632 ;; dired-do-flagged-delete.
2633 (interactive "P")
2634 (dired-internal-do-deletions
2635 ;; this may move point if ARG is an integer
2636 (dired-map-over-marks (cons (dired-get-filename) (point))
2637 arg)
f1a5d776 2638 arg t))
492d2437
RS
2639
2640(defvar dired-deletion-confirmer 'yes-or-no-p) ; or y-or-n-p?
2641
f1a5d776 2642(defun dired-internal-do-deletions (l arg &optional trash)
492d2437
RS
2643 ;; L is an alist of files to delete, with their buffer positions.
2644 ;; ARG is the prefix arg.
7c2fb837 2645 ;; Filenames are absolute.
492d2437
RS
2646 ;; (car L) *must* be the *last* (bottommost) file in the dired buffer.
2647 ;; That way as changes are made in the buffer they do not shift the
2648 ;; lines still to be changed, so the (point) values in L stay valid.
2649 ;; Also, for subdirs in natural order, a subdir's files are deleted
2650 ;; before the subdir itself - the other way around would not work.
f1a5d776
CY
2651 (let* ((files (mapcar (function car) l))
2652 (count (length l))
2653 (succ 0)
2654 (trashing (and trash delete-by-moving-to-trash))
2655 (progress-reporter
2656 (make-progress-reporter
2657 (if trashing "Trashing..." "Deleting...")
2658 succ count)))
492d2437
RS
2659 ;; canonicalize file list for pop up
2660 (setq files (nreverse (mapcar (function dired-make-relative) files)))
2661 (if (dired-mark-pop-up
2662 " *Deletions*" 'delete files dired-deletion-confirmer
f1a5d776
CY
2663 (format "%s %s "
2664 (if trashing "Trash" "Delete")
2665 (dired-mark-prompt arg files)))
84fc2cfa 2666 (save-excursion
492d2437
RS
2667 (let (failures);; files better be in reverse order for this loop!
2668 (while l
2669 (goto-char (cdr (car l)))
f836b98e 2670 (let ((inhibit-read-only t))
492d2437
RS
2671 (condition-case err
2672 (let ((fn (car (car l))))
f1a5d776 2673 (dired-delete-file fn dired-recursive-deletes trash)
492d2437
RS
2674 ;; if we get here, removing worked
2675 (setq succ (1+ succ))
f1a5d776 2676 (progress-reporter-update progress-reporter succ)
bf989169
RS
2677 (dired-fun-in-all-buffers
2678 (file-name-directory fn) (file-name-nondirectory fn)
2679 (function dired-delete-entry) fn))
492d2437
RS
2680 (error;; catch errors from failed deletions
2681 (dired-log "%s\n" err)
2682 (setq failures (cons (car (car l)) failures)))))
2683 (setq l (cdr l)))
2684 (if (not failures)
f1a5d776 2685 (progress-reporter-done progress-reporter)
492d2437
RS
2686 (dired-log-summary
2687 (format "%d of %d deletion%s failed"
2688 (length failures) count
2689 (dired-plural-s count))
2690 failures))))
2691 (message "(No deletions performed)")))
2692 (dired-move-to-filename))
2693
bf989169
RS
2694(defun dired-fun-in-all-buffers (directory file fun &rest args)
2695 ;; In all buffers dired'ing DIRECTORY, run FUN with ARGS.
2696 ;; If the buffer has a wildcard pattern, check that it matches FILE.
2697 ;; (FILE does not include a directory component.)
2698 ;; FILE may be nil, in which case ignore it.
2699 ;; Return list of buffers where FUN succeeded (i.e., returned non-nil).
2700 (let (success-list)
2701 (dolist (buf (dired-buffers-for-dir (expand-file-name directory)
2702 file))
2703 (with-current-buffer buf
2704 (if (apply fun args)
2705 (setq success-list (cons (buffer-name buf) success-list)))))
2706 success-list))
2707
c60ee5e7 2708;; Delete the entry for FILE from
bf989169
RS
2709(defun dired-delete-entry (file)
2710 (save-excursion
2711 (and (dired-goto-file file)
f836b98e 2712 (let ((inhibit-read-only t))
bf989169
RS
2713 (delete-region (progn (beginning-of-line) (point))
2714 (save-excursion (forward-line 1) (point))))))
2715 (dired-clean-up-after-deletion file))
2716
492d2437
RS
2717;; This is a separate function for the sake of dired-x.el.
2718(defun dired-clean-up-after-deletion (fn)
2719 ;; Clean up after a deleted file or directory FN.
7b2469ae
RS
2720 (save-excursion (and (cdr dired-subdir-alist)
2721 (dired-goto-subdir fn)
492d2437 2722 (dired-kill-subdir))))
83fadedf 2723\f
492d2437
RS
2724;; Confirmation
2725
2726(defun dired-marker-regexp ()
2727 (concat "^" (regexp-quote (char-to-string dired-marker-char))))
2728
2729(defun dired-plural-s (count)
2730 (if (= 1 count) "" "s"))
2731
2732(defun dired-mark-prompt (arg files)
bb5527ce
SM
2733 "Return a string for use in a prompt, either the current file
2734name, or the marker and a count of marked files."
2735 ;; distinguish-one-marked can cause the first element to be just t.
2736 (if (eq (car files) t) (setq files (cdr files)))
492d2437
RS
2737 (let ((count (length files)))
2738 (if (= count 1)
2739 (car files)
2740 ;; more than 1 file:
2741 (if (integerp arg)
2742 ;; abs(arg) = count
2743 ;; Perhaps this is nicer, but it also takes more screen space:
2744 ;;(format "[%s %d files]" (if (> arg 0) "next" "previous")
2745 ;; count)
2746 (format "[next %d files]" arg)
2747 (format "%c [%d files]" dired-marker-char count)))))
2748
2749(defun dired-pop-to-buffer (buf)
7f0995a1 2750 "Pop up buffer BUF in a way suitable for Dired."
19998f14
MR
2751 (let ((split-window-preferred-function
2752 (lambda (window)
b50e9ccf
MR
2753 (or (and (let ((split-height-threshold 0))
2754 (window-splittable-p (selected-window)))
19998f14
MR
2755 ;; Try to split the selected window vertically if
2756 ;; that's possible. (Bug#1806)
2757 (split-window-vertically))
2758 ;; Otherwise, try to split WINDOW sensibly.
2759 (split-window-sensibly window)))))
7f0995a1 2760 (pop-to-buffer (get-buffer-create buf)))
492d2437 2761 ;; If dired-shrink-to-fit is t, make its window fit its contents.
d7e78187 2762 (when dired-shrink-to-fit
4d0e7fe3
MR
2763 ;; Try to not delete window when we want to display less than
2764 ;; `window-min-height' lines.
2765 (fit-window-to-buffer (get-buffer-window buf) nil 1)))
492d2437 2766
5afea280 2767(defcustom dired-no-confirm nil
ee680b2b 2768 "A list of symbols for commands Dired should not confirm.
0347d069 2769Command symbols are `byte-compile', `chgrp', `chmod', `chown', `compress',
57654b8c 2770`copy', `delete', `hardlink', `load', `move', `print', `shell', `symlink',
5afea280
RS
2771`touch' and `uncompress'."
2772 :group 'dired
75461997
LT
2773 :type '(set (const byte-compile) (const chgrp)
2774 (const chmod) (const chown) (const compress)
2775 (const copy) (const delete) (const hardlink)
2776 (const load) (const move) (const print)
2777 (const shell) (const symlink) (const touch)
2778 (const uncompress)))
492d2437
RS
2779
2780(defun dired-mark-pop-up (bufname op-symbol files function &rest args)
8421685f
RS
2781 "Return FUNCTION's result on ARGS after showing which files are marked.
2782Displays the file names in a buffer named BUFNAME;
2783 nil gives \" *Marked Files*\".
2784This uses function `dired-pop-to-buffer' to do that.
2785
2786FUNCTION should not manipulate files, just read input
2787 (an argument or confirmation).
89101e46
SM
2788The window is not shown if there is just one file or
2789 OP-SYMBOL is a member of the list in `dired-no-confirm'.
09b092ad
RS
2790FILES is the list of marked files. It can also be (t FILENAME)
2791in the case of one marked file, to distinguish that from using
2792just the current file."
492d2437 2793 (or bufname (setq bufname " *Marked Files*"))
0347d069
SM
2794 (if (or (eq dired-no-confirm t)
2795 (memq op-symbol dired-no-confirm)
09b092ad 2796 ;; If FILES defaulted to the current line's file.
492d2437
RS
2797 (= (length files) 1))
2798 (apply function args)
89101e46 2799 (with-current-buffer (get-buffer-create bufname)
492d2437 2800 (erase-buffer)
09b092ad
RS
2801 ;; Handle (t FILE) just like (FILE), here.
2802 ;; That value is used (only in some cases), to mean
2803 ;; just one file that was marked, rather than the current line file.
2804 (dired-format-columns-of-files (if (eq (car files) t) (cdr files) files))
1a0b9ae6
EZ
2805 (remove-text-properties (point-min) (point-max)
2806 '(mouse-face nil help-echo nil)))
492d2437
RS
2807 (save-window-excursion
2808 (dired-pop-to-buffer bufname)
2809 (apply function args))))
2810
2811(defun dired-format-columns-of-files (files)
991ae4e4
SM
2812 (let ((beg (point)))
2813 (completion--insert-strings files)
2814 (put-text-property beg (point) 'mouse-face nil)))
83fadedf 2815\f
492d2437
RS
2816;; Commands to mark or flag file(s) at or near current line.
2817
2818(defun dired-repeat-over-lines (arg function)
2819 ;; This version skips non-file lines.
cfe89c4f 2820 (let ((pos (make-marker)))
492d2437 2821 (beginning-of-line)
cfe89c4f
RS
2822 (while (and (> arg 0) (not (eobp)))
2823 (setq arg (1- arg))
2824 (beginning-of-line)
2825 (while (and (not (eobp)) (dired-between-files)) (forward-line 1))
2826 (save-excursion
2827 (forward-line 1)
2828 (move-marker pos (1+ (point))))
2829 (save-excursion (funcall function))
2830 ;; Advance to the next line--actually, to the line that *was* next.
2831 ;; (If FUNCTION inserted some new lines in between, skip them.)
2832 (goto-char pos))
2833 (while (and (< arg 0) (not (bobp)))
2834 (setq arg (1+ arg))
2835 (forward-line -1)
2836 (while (and (not (bobp)) (dired-between-files)) (forward-line -1))
2837 (beginning-of-line)
2838 (save-excursion (funcall function)))
2839 (move-marker pos nil)
2840 (dired-move-to-filename)))
492d2437
RS
2841
2842(defun dired-between-files ()
8a372755
MB
2843 ;; This used to be a regexp match of the `total ...' line output by
2844 ;; ls, which is slightly faster, but that is not very robust; notably,
2845 ;; it fails for non-english locales.
2846 (save-excursion (not (dired-move-to-filename))))
492d2437
RS
2847
2848(defun dired-next-marked-file (arg &optional wrap opoint)
2849 "Move to the next marked file, wrapping around the end of the buffer."
2850 (interactive "p\np")
2851 (or opoint (setq opoint (point)));; return to where interactively started
2852 (if (if (> arg 0)
2853 (re-search-forward dired-re-mark nil t arg)
2854 (beginning-of-line)
2855 (re-search-backward dired-re-mark nil t (- arg)))
2856 (dired-move-to-filename)
2857 (if (null wrap)
2858 (progn
2859 (goto-char opoint)
2860 (error "No next marked file"))
2861 (message "(Wraparound for next marked file)")
2862 (goto-char (if (> arg 0) (point-min) (point-max)))
2863 (dired-next-marked-file arg nil opoint))))
2864
2865(defun dired-prev-marked-file (arg &optional wrap)
2866 "Move to the previous marked file, wrapping around the end of the buffer."
2867 (interactive "p\np")
2868 (dired-next-marked-file (- arg) wrap))
2869
2870(defun dired-file-marker (file)
2871 ;; Return FILE's marker, or nil if unmarked.
2872 (save-excursion
2873 (and (dired-goto-file file)
2874 (progn
2875 (beginning-of-line)
2876 (if (not (equal ?\040 (following-char)))
2877 (following-char))))))
2878
2879(defun dired-mark-files-in-region (start end)
f836b98e 2880 (let ((inhibit-read-only t))
492d2437
RS
2881 (if (> start end)
2882 (error "start > end"))
2883 (goto-char start) ; assumed at beginning of line
2884 (while (< (point) end)
2885 ;; Skip subdir line and following garbage like the `total' line:
2886 (while (and (< (point) end) (dired-between-files))
2887 (forward-line 1))
2888 (if (and (not (looking-at dired-re-dot))
2889 (dired-get-filename nil t))
2890 (progn
2891 (delete-char 1)
2892 (insert dired-marker-char)))
2893 (forward-line 1))))
2894
2895(defun dired-mark (arg)
2896 "Mark the current (or next ARG) files.
2897If on a subdir headerline, mark all its files except `.' and `..'.
2898
2899Use \\[dired-unmark-all-files] to remove all marks
2900and \\[dired-unmark] on a subdir to remove the marks in
2901this subdir."
2902 (interactive "P")
277568f2 2903 (if (dired-get-subdir)
492d2437 2904 (save-excursion (dired-mark-subdir-files))
f836b98e 2905 (let ((inhibit-read-only t))
492d2437 2906 (dired-repeat-over-lines
52041219 2907 (prefix-numeric-value arg)
492d2437
RS
2908 (function (lambda () (delete-char 1) (insert dired-marker-char)))))))
2909
2910(defun dired-unmark (arg)
2911 "Unmark the current (or next ARG) files.
2912If looking at a subdir, unmark all its files except `.' and `..'."
2913 (interactive "P")
2914 (let ((dired-marker-char ?\040))
2915 (dired-mark arg)))
2916
2917(defun dired-flag-file-deletion (arg)
68d2f12f 2918 "In Dired, flag the current line's file for deletion.
492d2437
RS
2919With prefix arg, repeat over several lines.
2920
2921If on a subdir headerline, mark all its files except `.' and `..'."
2922 (interactive "P")
2923 (let ((dired-marker-char dired-del-marker))
2924 (dired-mark arg)))
2925
2926(defun dired-unmark-backward (arg)
68d2f12f 2927 "In Dired, move up lines and remove deletion flag there.
492d2437
RS
2928Optional prefix ARG says how many lines to unflag; default is one line."
2929 (interactive "p")
2930 (dired-unmark (- arg)))
e5f0841e 2931
d588eb90
RS
2932(defun dired-toggle-marks ()
2933 "Toggle marks: marked files become unmarked, and vice versa.
e5f0841e
KH
2934Files marked with other flags (such as `D') are not affected.
2935`.' and `..' are never toggled.
2936As always, hidden subdirs are not affected."
2937 (interactive)
2938 (save-excursion
2939 (goto-char (point-min))
f836b98e 2940 (let ((inhibit-read-only t))
e5f0841e
KH
2941 (while (not (eobp))
2942 (or (dired-between-files)
2943 (looking-at dired-re-dot)
2944 ;; use subst instead of insdel because it does not move
2945 ;; the gap and thus should be faster and because
2946 ;; other characters are left alone automatically
2947 (apply 'subst-char-in-region
2948 (point) (1+ (point))
2949 (if (eq ?\040 (following-char)) ; SPC
2950 (list ?\040 dired-marker-char)
2951 (list dired-marker-char ?\040))))
2952 (forward-line 1)))))
83fadedf 2953\f
492d2437
RS
2954;;; Commands to mark or flag files based on their characteristics or names.
2955
d2cadc4b
RS
2956(defvar dired-regexp-history nil
2957 "History list of regular expressions used in Dired commands.")
2958
2959(defun dired-read-regexp (prompt)
2960 (read-from-minibuffer prompt nil nil nil 'dired-regexp-history))
492d2437
RS
2961
2962(defun dired-mark-files-regexp (regexp &optional marker-char)
2963 "Mark all files matching REGEXP for use in later commands.
2964A prefix argument means to unmark them instead.
2965`.' and `..' are never marked.
2966
2967REGEXP is an Emacs regexp, not a shell wildcard. Thus, use `\\.o$' for
2968object files--just `.o' will mark more than you might think."
2969 (interactive
2970 (list (dired-read-regexp (concat (if current-prefix-arg "Unmark" "Mark")
2971 " files (regexp): "))
2972 (if current-prefix-arg ?\040)))
2973 (let ((dired-marker-char (or marker-char dired-marker-char)))
2974 (dired-mark-if
2975 (and (not (looking-at dired-re-dot))
2976 (not (eolp)) ; empty line
2977 (let ((fn (dired-get-filename nil t)))
2978 (and fn (string-match regexp (file-name-nondirectory fn)))))
2979 "matching file")))
2980
e9b8e22d
RS
2981(defun dired-mark-files-containing-regexp (regexp &optional marker-char)
2982 "Mark all files with contents containing REGEXP for use in later commands.
2983A prefix argument means to unmark them instead.
2984`.' and `..' are never marked."
2985 (interactive
2986 (list (dired-read-regexp (concat (if current-prefix-arg "Unmark" "Mark")
2987 " files containing (regexp): "))
2988 (if current-prefix-arg ?\040)))
2989 (let ((dired-marker-char (or marker-char dired-marker-char)))
2990 (dired-mark-if
2991 (and (not (looking-at dired-re-dot))
2992 (not (eolp)) ; empty line
2993 (let ((fn (dired-get-filename nil t)))
05a40373
KH
2994 (when (and fn (file-readable-p fn)
2995 (not (file-directory-p fn)))
2996 (let ((prebuf (get-file-buffer fn)))
2997 (message "Checking %s" fn)
2998 ;; For now we do it inside emacs
2999 ;; Grep might be better if there are a lot of files
3000 (if prebuf
3001 (with-current-buffer prebuf
3002 (save-excursion
3003 (goto-char (point-min))
3004 (re-search-forward regexp nil t)))
3005 (with-temp-buffer
3006 (insert-file-contents fn)
3007 (goto-char (point-min))
3008 (re-search-forward regexp nil t))))
0b2bb4d0 3009 )))
e9b8e22d
RS
3010 "matching file")))
3011
492d2437 3012(defun dired-flag-files-regexp (regexp)
68d2f12f 3013 "In Dired, flag all files containing the specified REGEXP for deletion.
492d2437
RS
3014The match is against the non-directory part of the filename. Use `^'
3015 and `$' to anchor matches. Exclude subdirs by hiding them.
3016`.' and `..' are never flagged."
3017 (interactive (list (dired-read-regexp "Flag for deletion (regexp): ")))
3018 (dired-mark-files-regexp regexp dired-del-marker))
3019
3020(defun dired-mark-symlinks (unflag-p)
3021 "Mark all symbolic links.
3022With prefix argument, unflag all those files."
3023 (interactive "P")
3024 (let ((dired-marker-char (if unflag-p ?\040 dired-marker-char)))
3025 (dired-mark-if (looking-at dired-re-sym) "symbolic link")))
3026
3027(defun dired-mark-directories (unflag-p)
3028 "Mark all directory file lines except `.' and `..'.
3029With prefix argument, unflag all those files."
3030 (interactive "P")
3031 (let ((dired-marker-char (if unflag-p ?\040 dired-marker-char)))
3032 (dired-mark-if (and (looking-at dired-re-dir)
3033 (not (looking-at dired-re-dot)))
3034 "directory file")))
3035
3036(defun dired-mark-executables (unflag-p)
3037 "Mark all executable files.
3038With prefix argument, unflag all those files."
3039 (interactive "P")
3040 (let ((dired-marker-char (if unflag-p ?\040 dired-marker-char)))
3041 (dired-mark-if (looking-at dired-re-exe) "executable file")))
3042
3043;; dired-x.el has a dired-mark-sexp interactive command: mark
3044;; files for which PREDICATE returns non-nil.
3045
3046(defun dired-flag-auto-save-files (&optional unflag-p)
84fc2cfa
ER
3047 "Flag for deletion files whose names suggest they are auto save files.
3048A prefix argument says to unflag those files instead."
3049 (interactive "P")
492d2437
RS
3050 (let ((dired-marker-char (if unflag-p ?\040 dired-del-marker)))
3051 (dired-mark-if
2a838614 3052 ;; It is less than general to check for # here,
a91526b9
RS
3053 ;; but it's the only way this runs fast enough.
3054 (and (save-excursion (end-of-line)
536ae2dd
RS
3055 (or
3056 (eq (preceding-char) ?#)
3057 ;; Handle executables in case of -F option.
3058 ;; We need not worry about the other kinds
3059 ;; of markings that -F makes, since they won't
3060 ;; appear on real auto-save files.
3061 (if (eq (preceding-char) ?*)
3062 (progn
3063 (forward-char -1)
3064 (eq (preceding-char) ?#)))))
a91526b9
RS
3065 (not (looking-at dired-re-dir))
3066 (let ((fn (dired-get-filename t t)))
3067 (if fn (auto-save-file-name-p
3068 (file-name-nondirectory fn)))))
3069 "auto save file")))
492d2437 3070
d7aed37c 3071(defcustom dired-garbage-files-regexp
6736ab5a 3072 ;; `log' here is dubious, since it's typically used for useful log
d7aed37c 3073 ;; files, not just TeX stuff. -- fx
d4aeef3b
KG
3074 (concat (regexp-opt
3075 '(".log" ".toc" ".dvi" ".bak" ".orig" ".rej" ".aux"))
c60ee5e7 3076 "\\'")
d7aed37c
SM
3077 "Regular expression to match \"garbage\" files for `dired-flag-garbage-files'."
3078 :type 'regexp
3079 :group 'dired)
84d3f6e8
RS
3080
3081(defun dired-flag-garbage-files ()
84d3f6e8 3082 "Flag for deletion all files that match `dired-garbage-files-regexp'."
f656ec48 3083 (interactive)
84d3f6e8
RS
3084 (dired-flag-files-regexp dired-garbage-files-regexp))
3085
492d2437
RS
3086(defun dired-flag-backup-files (&optional unflag-p)
3087 "Flag all backup files (names ending with `~') for deletion.
3088With prefix argument, unflag these files."
3089 (interactive "P")
ee680b2b 3090 (let ((dired-marker-char (if unflag-p ?\s dired-del-marker)))
492d2437 3091 (dired-mark-if
f13101e9
KH
3092 ;; Don't call backup-file-name-p unless the last character looks like
3093 ;; it might be the end of a backup file name. This isn't very general,
a91526b9
RS
3094 ;; but it's the only way this runs fast enough.
3095 (and (save-excursion (end-of-line)
f13101e9
KH
3096 ;; Handle executables in case of -F option.
3097 ;; We need not worry about the other kinds
3098 ;; of markings that -F makes, since they won't
3099 ;; appear on real backup files.
3100 (if (eq (preceding-char) ?*)
3101 (forward-char -1))
fdee13ec 3102 (eq (preceding-char) ?~))
a91526b9 3103 (not (looking-at dired-re-dir))
492d2437
RS
3104 (let ((fn (dired-get-filename t t)))
3105 (if fn (backup-file-name-p fn))))
3106 "backup file")))
3107
6482fcac
RS
3108(defun dired-change-marks (&optional old new)
3109 "Change all OLD marks to NEW marks.
3110OLD and NEW are both characters used to mark files."
3111 (interactive
3112 (let* ((cursor-in-echo-area t)
3113 (old (progn (message "Change (old mark): ") (read-char)))
3114 (new (progn (message "Change %c marks to (new mark): " old)
3115 (read-char))))
3116 (list old new)))
e4e02841
RS
3117 (if (or (eq old ?\r) (eq new ?\r))
3118 (ding)
3119 (let ((string (format "\n%c" old))
f836b98e 3120 (inhibit-read-only t))
e4e02841
RS
3121 (save-excursion
3122 (goto-char (point-min))
3123 (while (search-forward string nil t)
ee680b2b 3124 (if (if (= old ?\s)
a15a76f7
RS
3125 (save-match-data
3126 (dired-get-filename 'no-dir t))
3127 t)
3128 (subst-char-in-region (match-beginning 0)
3129 (match-end 0) old new)))))))
6482fcac 3130
534a6edf 3131(defun dired-unmark-all-marks ()
ee680b2b 3132 "Remove all marks from all files in the dired buffer."
b1ecd9c6
RS
3133 (interactive)
3134 (dired-unmark-all-files ?\r))
3135
8b87a301 3136(defun dired-unmark-all-files (mark &optional arg)
b602ba2f 3137 "Remove a specific mark (or any mark) from every file.
c60ee5e7 3138After this command, type the mark character to remove,
b602ba2f 3139or type RET to remove all marks.
3585916f 3140With prefix arg, query for each marked file.
492d2437 3141Type \\[help-command] at that time for help."
b602ba2f
RS
3142 (interactive "cRemove marks (RET means all): \nP")
3143 (save-excursion
3144 (let* ((count 0)
f836b98e 3145 (inhibit-read-only t) case-fold-search query
b602ba2f
RS
3146 (string (format "\n%c" mark))
3147 (help-form "\
8b87a301
RS
3148Type SPC or `y' to unmark one file, DEL or `n' to skip to next,
3149`!' to unmark all remaining files with no more questions."))
b602ba2f
RS
3150 (goto-char (point-min))
3151 (while (if (eq mark ?\r)
3152 (re-search-forward dired-re-mark nil t)
3153 (search-forward string nil t))
3154 (if (or (not arg)
e9407052
RS
3155 (let ((file (dired-get-filename t t)))
3156 (and file
3157 (dired-query 'query "Unmark file `%s'? "
3158 file))))
b602ba2f 3159 (progn (subst-char-in-region (1- (point)) (point)
ee680b2b 3160 (preceding-char) ?\s)
b602ba2f
RS
3161 (setq count (1+ count)))))
3162 (message (if (= count 1) "1 mark removed"
3163 "%d marks removed")
3164 count))))
83fadedf 3165\f
492d2437 3166;; Logging failures operating on files, and showing the results.
84fc2cfa 3167
492d2437 3168(defvar dired-log-buffer "*Dired log*")
84fc2cfa 3169
492d2437
RS
3170(defun dired-why ()
3171 "Pop up a buffer with error log output from Dired.
3172A group of errors from a single command ends with a formfeed.
3173Thus, use \\[backward-page] to find the beginning of a group of errors."
3174 (interactive)
3175 (if (get-buffer dired-log-buffer)
3176 (let ((owindow (selected-window))
3177 (window (display-buffer (get-buffer dired-log-buffer))))
3178 (unwind-protect
6482fcac 3179 (progn
492d2437
RS
3180 (select-window window)
3181 (goto-char (point-max))
0b7bc76f
RS
3182 (forward-line -1)
3183 (backward-page 1)
3184 (recenter 0))
492d2437
RS
3185 (select-window owindow)))))
3186
3187(defun dired-log (log &rest args)
3188 ;; Log a message or the contents of a buffer.
3189 ;; If LOG is a string and there are more args, it is formatted with
3190 ;; those ARGS. Usually the LOG string ends with a \n.
c60ee5e7 3191 ;; End each bunch of errors with (dired-log t):
0b7bc76f
RS
3192 ;; this inserts the current time and buffer at the start of the page,
3193 ;; and \f (formfeed) at the end.
492d2437 3194 (let ((obuf (current-buffer)))
0b7bc76f
RS
3195 (with-current-buffer (get-buffer-create dired-log-buffer)
3196 (goto-char (point-max))
3197 (let ((inhibit-read-only t))
3198 (cond ((stringp log)
3199 (insert (if args
3200 (apply (function format) log args)
3201 log)))
3202 ((bufferp log)
88cb5d3c 3203 (insert-buffer-substring log))
0b7bc76f
RS
3204 ((eq t log)
3205 (backward-page 1)
3206 (unless (bolp)
3207 (insert "\n"))
3208 (insert (current-time-string)
3209 "\tBuffer `" (buffer-name obuf) "'\n")
3210 (goto-char (point-max))
3211 (insert "\f\n")))))))
492d2437
RS
3212
3213(defun dired-log-summary (string failures)
ddcfebf1
RS
3214 "State a summary of a command's failures, in echo area and log buffer.
3215STRING is an overall summary of the failures.
3216FAILURES is a list of file names that we failed to operate on,
3217or nil if file names are not applicable."
0b7bc76f
RS
3218 (if (= (length failures) 1)
3219 (message "%s"
3220 (with-current-buffer dired-log-buffer
3221 (goto-char (point-max))
3222 (backward-page 1)
3223 (if (eolp) (forward-line 1))
3224 (buffer-substring (point) (point-max))))
3225 (message (if failures "%s--type ? for details (%s)"
3226 "%s--type ? for details")
3227 string failures))
492d2437 3228 ;; Log a summary describing a bunch of errors.
0b7bc76f 3229 (dired-log (concat "\n" string "\n"))
492d2437 3230 (dired-log t))
83fadedf 3231\f
492d2437
RS
3232;;; Sorting
3233
3234;; Most ls can only sort by name or by date (with -t), nothing else.
3235;; GNU ls sorts on size with -S, on extension with -X, and unsorted with -U.
3236;; So anything that does not contain these is sort "by name".
3237
3238(defvar dired-ls-sorting-switches "SXU"
87ae59e3 3239 "String of `ls' switches \(single letters\) except \"t\" that influence sorting.
cfc8b264
EZ
3240
3241This indicates to Dired which option switches to watch out for because they
3242will change the sorting order behavior of `ls'.
3243
3244To change the default sorting order \(e.g. add a `-v' option\), see the
3245variable `dired-listing-switches'. To temporarily override the listing
3246format, use `\\[universal-argument] \\[dired]'.")
492d2437
RS
3247
3248(defvar dired-sort-by-date-regexp
3249 (concat "^-[^" dired-ls-sorting-switches
3250 "]*t[^" dired-ls-sorting-switches "]*$")
ee680b2b 3251 "Regexp recognized by Dired to set `by date' mode.")
492d2437
RS
3252
3253(defvar dired-sort-by-name-regexp
3254 (concat "^-[^t" dired-ls-sorting-switches "]+$")
ee680b2b 3255 "Regexp recognized by Dired to set `by name' mode.")
492d2437 3256
23fc67ea
RS
3257(defvar dired-sort-inhibit nil
3258 "Non-nil means the Dired sort command is disabled.
ee680b2b 3259The idea is to set this buffer-locally in special dired buffers.")
23fc67ea 3260
492d2437
RS
3261(defun dired-sort-set-modeline ()
3262 ;; Set modeline display according to dired-actual-switches.
3263 ;; Modeline display of "by name" or "by date" guarantees the user a
3264 ;; match with the corresponding regexps. Non-matching switches are
3265 ;; shown literally.
5641671f
NR
3266 (when (eq major-mode 'dired-mode)
3267 (setq mode-name
3268 (let (case-fold-search)
098bab71 3269 (cond ((string-match
5641671f
NR
3270 dired-sort-by-name-regexp dired-actual-switches)
3271 "Dired by name")
3272 ((string-match
3273 dired-sort-by-date-regexp dired-actual-switches)
3274 "Dired by date")
3275 (t
3276 (concat "Dired " dired-actual-switches)))))
3277 (force-mode-line-update)))
492d2437
RS
3278
3279(defun dired-sort-toggle-or-edit (&optional arg)
3280 "Toggle between sort by date/name and refresh the dired buffer.
3281With a prefix argument you can edit the current listing switches instead."
84fc2cfa 3282 (interactive "P")
23fc67ea 3283 (when dired-sort-inhibit
ee680b2b 3284 (error "Cannot sort this dired buffer"))
492d2437
RS
3285 (if arg
3286 (dired-sort-other
3287 (read-string "ls switches (must contain -l): " dired-actual-switches))
3288 (dired-sort-toggle)))
3289
3290(defun dired-sort-toggle ()
3291 ;; Toggle between sort by date/name. Reverts the buffer.
3292 (setq dired-actual-switches
3293 (let (case-fold-search)
7820b28f
RS
3294 (if (string-match " " dired-actual-switches)
3295 ;; New toggle scheme: add/remove a trailing " -t"
3296 (if (string-match " -t\\'" dired-actual-switches)
2b2059d8 3297 (substring dired-actual-switches 0 (match-beginning 0))
7820b28f
RS
3298 (concat dired-actual-switches " -t"))
3299 ;; old toggle scheme: look for some 't' switch and add/remove it
3300 (concat
3301 "-l"
83fadedf
DL
3302 (dired-replace-in-string (concat "[-lt"
3303 dired-ls-sorting-switches "]")
3304 ""
3305 dired-actual-switches)
7820b28f
RS
3306 (if (string-match (concat "[t" dired-ls-sorting-switches "]")
3307 dired-actual-switches)
3308 ""
3309 "t")))))
492d2437
RS
3310 (dired-sort-set-modeline)
3311 (revert-buffer))
3312
83fadedf 3313;; Some user code loads dired especially for this.
879fa8d0 3314;; Don't do that--use replace-regexp-in-string instead.
83fadedf
DL
3315(defun dired-replace-in-string (regexp newtext string)
3316 ;; Replace REGEXP with NEWTEXT everywhere in STRING and return result.
3317 ;; NEWTEXT is taken literally---no \\DIGIT escapes will be recognized.
3318 (let ((result "") (start 0) mb me)
3319 (while (string-match regexp string start)
3320 (setq mb (match-beginning 0)
3321 me (match-end 0)
3322 result (concat result (substring string start mb) newtext)
3323 start me))
3324 (concat result (substring string start))))
3325
492d2437 3326(defun dired-sort-other (switches &optional no-revert)
ee680b2b 3327 "Specify new `ls' SWITCHES for current dired buffer.
ff3d76aa
SM
3328Values matching `dired-sort-by-date-regexp' or `dired-sort-by-name-regexp'
3329set the minor mode accordingly, others appear literally in the mode line.
3330With optional second arg NO-REVERT, don't refresh the listing afterwards."
e17dba1f 3331 (dired-sort-R-check switches)
492d2437 3332 (setq dired-actual-switches switches)
5641671f 3333 (dired-sort-set-modeline)
492d2437 3334 (or no-revert (revert-buffer)))
e17dba1f 3335
5afea280
RS
3336(defvar dired-subdir-alist-pre-R nil
3337 "Value of `dired-subdir-alist' before -R switch added.")
75461997 3338(make-variable-buffer-local 'dired-subdir-alist-pre-R)
e17dba1f
GM
3339
3340(defun dired-sort-R-check (switches)
3341 "Additional processing of -R in ls option string SWITCHES.
3342Saves `dired-subdir-alist' when R is set and restores saved value
3343minus any directories explicitly deleted when R is cleared.
3344To be called first in body of `dired-sort-other', etc."
3345 (cond
3346 ((and (string-match "R" switches)
3347 (not (string-match "R" dired-actual-switches)))
3348 ;; Adding -R to ls switches -- save `dired-subdir-alist':
3349 (setq dired-subdir-alist-pre-R dired-subdir-alist))
3350 ((and (string-match "R" dired-actual-switches)
3351 (not (string-match "R" switches)))
3352 ;; Deleting -R from ls switches -- revert to pre-R subdirs
3353 ;; that are still present:
3354 (setq dired-subdir-alist
3355 (if dired-subdir-alist-pre-R
3356 (let (subdirs)
3357 (while dired-subdir-alist-pre-R
3358 (if (assoc (caar dired-subdir-alist-pre-R)
3359 dired-subdir-alist)
3360 ;; subdir still present...
3361 (setq subdirs
3362 (cons (car dired-subdir-alist-pre-R)
3363 subdirs)))
3364 (setq dired-subdir-alist-pre-R
3365 (cdr dired-subdir-alist-pre-R)))
3366 (reverse subdirs))
3367 ;; No pre-R subdir alist, so revert to main directory
3368 ;; listing:
3369 (list (car (reverse dired-subdir-alist))))))))
83fadedf 3370\f
133aad74
JD
3371
3372;;;; Drag and drop support
3373
773933d3 3374(defcustom dired-recursive-copies 'top
9201cc28 3375 "Decide whether recursive copies are allowed.
098bab71 3376A value of nil means no recursive copies.
fe02ba07
RS
3377`always' means copy recursively without asking.
3378`top' means ask for each directory at top level.
3379Anything else means ask for each directory."
3380 :type '(choice :tag "Copy directories"
3381 (const :tag "No recursive copies" nil)
3382 (const :tag "Ask for each directory" t)
3383 (const :tag "Ask for each top directory only" top)
3384 (const :tag "Copy directories without asking" always))
3385 :group 'dired)
3386
133aad74 3387(defun dired-dnd-popup-notice ()
fcaed7ce 3388 (message-box
3b1b11e9 3389 "Dired recursive copies are currently disabled.\nSee the variable `dired-recursive-copies'."))
133aad74 3390
e8a11b22 3391(declare-function x-popup-menu "menu.c" (position menu))
133aad74
JD
3392
3393(defun dired-dnd-do-ask-action (uri)
3394 ;; No need to get actions and descriptions from the source,
3395 ;; we only have three actions anyway.
5553077c 3396 (let ((action (x-popup-menu
133aad74
JD
3397 t
3398 (list "What action?"
3399 (cons ""
3400 '(("Copy here" . copy)
3401 ("Move here" . move)
3402 ("Link here" . link)
3403 "--"
3404 ("Cancel" . nil)))))))
3405 (if action
3406 (dired-dnd-handle-local-file uri action)
3407 nil)))
3408
5c4fa70f 3409(declare-function dired-relist-entry "dired-aux" (file))
f36d1cdc 3410(declare-function make-symbolic-link "fileio.c")
5c4fa70f 3411
aa360da1
GM
3412;; Only used when (featurep 'dnd).
3413(declare-function dnd-get-local-file-name "dnd" (uri &optional must-exist))
3414(declare-function dnd-get-local-file-uri "dnd" (uri))
3415
133aad74
JD
3416(defun dired-dnd-handle-local-file (uri action)
3417 "Copy, move or link a file to the dired directory.
3418URI is the file to handle, ACTION is one of copy, move, link or ask.
3419Ask means pop up a menu for the user to select one of copy, move or link."
3420 (require 'dired-aux)
361eee8f 3421 (let* ((from (dnd-get-local-file-name uri t))
93ab4de3
CY
3422 (to (when from
3423 (concat (dired-current-directory)
3424 (file-name-nondirectory from)))))
61bfceb6 3425 (when from
93ab4de3 3426 (cond ((eq action 'ask)
61bfceb6 3427 (dired-dnd-do-ask-action uri))
93ab4de3
CY
3428 ;; If copying a directory and dired-recursive-copies is
3429 ;; nil, dired-copy-file fails. Pop up a notice.
3430 ((and (memq action '(copy private))
3431 (file-directory-p from)
3432 (not dired-recursive-copies))
3433 (dired-dnd-popup-notice))
3434 ((memq action '(copy private move link))
3435 (let ((overwrite (and (file-exists-p to)
3436 (y-or-n-p
3437 (format "Overwrite existing file `%s'? " to))))
3438 ;; Binding dired-overwrite-confirmed to nil makes
3439 ;; dired-handle-overwrite a no-op. We instead use
3440 ;; y-or-n-p, which pops a graphical menu.
3441 dired-overwrite-confirmed backup-file)
3442 (when (and overwrite
3443 ;; d-b-o is defined in dired-aux.
3444 (boundp 'dired-backup-overwrite)
3445 dired-backup-overwrite
3446 (setq backup-file
3447 (car (find-backup-file-name to)))
3448 (or (eq dired-backup-overwrite 'always)
3449 (y-or-n-p
3450 (format
3451 "Make backup for existing file `%s'? " to))))
3452 (rename-file to backup-file 0)
3453 (dired-relist-entry backup-file))
3454 (cond ((memq action '(copy private))
3455 (dired-copy-file from to overwrite))
3456 ((eq action 'move)
3457 (dired-rename-file from to overwrite))
3458 ((eq action 'link)
3459 (make-symbolic-link from to overwrite)))
3460 (dired-relist-entry to)
3461 action))))))
133aad74
JD
3462
3463(defun dired-dnd-handle-file (uri action)
3464 "Copy, move or link a file to the dired directory if it is a local file.
3465URI is the file to handle. If the hostname in the URI isn't local, do nothing.
3466ACTION is one of copy, move, link or ask.
3467Ask means pop up a menu for the user to select one of copy, move or link."
361eee8f 3468 (let ((local-file (dnd-get-local-file-uri uri)))
133aad74
JD
3469 (if local-file (dired-dnd-handle-local-file local-file action)
3470 nil)))
31b4c848
LH
3471\f
3472
3473;;;; Desktop support
3474
3475(eval-when-compile (require 'desktop))
3476
3477(defun dired-desktop-buffer-misc-data (desktop-dirname)
3478 "Auxiliary information to be saved in desktop file."
3479 (cons
3480 ;; Value of `dired-directory'.
3481 (if (consp dired-directory)
3482 ;; Directory name followed by list of files.
3483 (cons (desktop-file-name (car dired-directory) desktop-dirname)
3484 (cdr dired-directory))
9d9ee410 3485 ;; Directory name, optionally with shell wildcard.
31b4c848
LH
3486 (desktop-file-name dired-directory desktop-dirname))
3487 ;; Subdirectories in `dired-subdir-alist'.
3488 (cdr
3489 (nreverse
3490 (mapcar
3491 (function (lambda (f) (desktop-file-name (car f) desktop-dirname)))
3492 dired-subdir-alist)))))
133aad74 3493
31b4c848
LH
3494(defun dired-restore-desktop-buffer (desktop-buffer-file-name
3495 desktop-buffer-name
3496 desktop-buffer-misc)
3497 "Restore a dired buffer specified in a desktop file."
3498 ;; First element of `desktop-buffer-misc' is the value of `dired-directory'.
9d9ee410 3499 ;; This value is a directory name, optionally with shell wildcard or
31b4c848
LH
3500 ;; a directory name followed by list of files.
3501 (let* ((dired-dir (car desktop-buffer-misc))
3502 (dir (if (consp dired-dir) (car dired-dir) dired-dir)))
3503 (if (file-directory-p (file-name-directory dir))
3504 (progn
3505 (dired dired-dir)
3506 ;; The following elements of `desktop-buffer-misc' are the keys
3507 ;; from `dired-subdir-alist'.
6ba03ad9 3508 (mapc 'dired-maybe-insert-subdir (cdr desktop-buffer-misc))
31b4c848
LH
3509 (current-buffer))
3510 (message "Desktop: Directory %s no longer exists." dir)
3511 (when desktop-missing-file-warning (sit-for 1))
3512 nil)))
133aad74 3513
9e7357b0
AS
3514(add-to-list 'desktop-buffer-mode-handlers
3515 '(dired-mode . dired-restore-desktop-buffer))
a515788d 3516
133aad74 3517\f
7d72f6f1
GM
3518;;; Start of automatically extracted autoloads.
3519\f
3520;;;### (autoloads (dired-show-file-type dired-do-query-replace-regexp
3521;;;;;; dired-do-search dired-do-isearch-regexp dired-do-isearch
3522;;;;;; dired-isearch-filenames-regexp dired-isearch-filenames dired-isearch-filenames-setup
3523;;;;;; dired-hide-all dired-hide-subdir dired-tree-down dired-tree-up
3524;;;;;; dired-kill-subdir dired-mark-subdir-files dired-goto-subdir
3525;;;;;; dired-prev-subdir dired-insert-subdir dired-maybe-insert-subdir
3526;;;;;; dired-downcase dired-upcase dired-do-symlink-regexp dired-do-hardlink-regexp
3527;;;;;; dired-do-copy-regexp dired-do-rename-regexp dired-do-rename
3528;;;;;; dired-do-hardlink dired-do-symlink dired-do-copy dired-create-directory
3529;;;;;; dired-rename-file dired-copy-file dired-relist-file dired-remove-file
3530;;;;;; dired-add-file dired-do-redisplay dired-do-load dired-do-byte-compile
3531;;;;;; dired-do-compress dired-query dired-compress-file dired-do-kill-lines
3532;;;;;; dired-run-shell-command dired-do-shell-command dired-do-async-shell-command
3533;;;;;; dired-clean-directory dired-do-print dired-do-touch dired-do-chown
3534;;;;;; dired-do-chgrp dired-do-chmod dired-compare-directories dired-backup-diff
8ae41cbc 3535;;;;;; dired-diff) "dired-aux" "dired-aux.el" "07676ea25af17f5d50cc5db4f53bddc0")
7d72f6f1
GM
3536;;; Generated autoloads from dired-aux.el
3537
3538(autoload 'dired-diff "dired-aux" "\
3539Compare file at point with file FILE using `diff'.
3540FILE defaults to the file at the mark. (That's the mark set by
3541\\[set-mark-command], not by Dired's \\[dired-mark] command.)
3542The prompted-for file is the first file given to `diff'.
3543With prefix arg, prompt for second argument SWITCHES,
3544which is options for `diff'.
3545
3546\(fn FILE &optional SWITCHES)" t nil)
3547
3548(autoload 'dired-backup-diff "dired-aux" "\
3549Diff this file with its backup file or vice versa.
3550Uses the latest backup, if there are several numerical backups.
3551If this file is a backup, diff it with its original.
3552The backup file is the first file given to `diff'.
3553With prefix arg, prompt for argument SWITCHES which is options for `diff'.
3554
3555\(fn &optional SWITCHES)" t nil)
3556
3557(autoload 'dired-compare-directories "dired-aux" "\
3558Mark files with different file attributes in two dired buffers.
3559Compare file attributes of files in the current directory
3560with file attributes in directory DIR2 using PREDICATE on pairs of files
3561with the same name. Mark files for which PREDICATE returns non-nil.
3562Mark files with different names if PREDICATE is nil (or interactively
3563with empty input at the predicate prompt).
3564
3565PREDICATE is a Lisp expression that can refer to the following variables:
3566
3567 size1, size2 - file size in bytes
3568 mtime1, mtime2 - last modification time in seconds, as a float
3569 fa1, fa2 - list of file attributes
3570 returned by function `file-attributes'
3571
3572 where 1 refers to attribute of file in the current dired buffer
3573 and 2 to attribute of file in second dired buffer.
3574
3575Examples of PREDICATE:
3576
3577 (> mtime1 mtime2) - mark newer files
3578 (not (= size1 size2)) - mark files with different sizes
3579 (not (string= (nth 8 fa1) (nth 8 fa2))) - mark files with different modes
3580 (not (and (= (nth 2 fa1) (nth 2 fa2)) - mark files with different UID
3581 (= (nth 3 fa1) (nth 3 fa2)))) and GID.
3582
3583\(fn DIR2 PREDICATE)" t nil)
3584
3585(autoload 'dired-do-chmod "dired-aux" "\
3586Change the mode of the marked (or next ARG) files.
3587Symbolic modes like `g+w' are allowed.
3588
3589\(fn &optional ARG)" t nil)
3590
3591(autoload 'dired-do-chgrp "dired-aux" "\
3592Change the group of the marked (or next ARG) files.
3593
3594\(fn &optional ARG)" t nil)
3595
3596(autoload 'dired-do-chown "dired-aux" "\
3597Change the owner of the marked (or next ARG) files.
3598
3599\(fn &optional ARG)" t nil)
3600
3601(autoload 'dired-do-touch "dired-aux" "\
3602Change the timestamp of the marked (or next ARG) files.
3603This calls touch.
3604
3605\(fn &optional ARG)" t nil)
3606
3607(autoload 'dired-do-print "dired-aux" "\
3608Print the marked (or next ARG) files.
3609Uses the shell command coming from variables `lpr-command' and
3610`lpr-switches' as default.
3611
3612\(fn &optional ARG)" t nil)
3613
3614(autoload 'dired-clean-directory "dired-aux" "\
3615Flag numerical backups for deletion.
3616Spares `dired-kept-versions' latest versions, and `kept-old-versions' oldest.
3617Positive prefix arg KEEP overrides `dired-kept-versions';
3618Negative prefix arg KEEP overrides `kept-old-versions' with KEEP made positive.
3619
3620To clear the flags on these files, you can use \\[dired-flag-backup-files]
3621with a prefix argument.
3622
3623\(fn KEEP)" t nil)
3624
3625(autoload 'dired-do-async-shell-command "dired-aux" "\
3626Run a shell command COMMAND on the marked files asynchronously.
3627
3628Like `dired-do-shell-command' but if COMMAND doesn't end in ampersand,
3629adds `* &' surrounded by whitespace and executes the command asynchronously.
3630The output appears in the buffer `*Async Shell Command*'.
3631
3632\(fn COMMAND &optional ARG FILE-LIST)" t nil)
3633
3634(autoload 'dired-do-shell-command "dired-aux" "\
3635Run a shell command COMMAND on the marked files.
3636If no files are marked or a specific numeric prefix arg is given,
3637the next ARG files are used. Just \\[universal-argument] means the current file.
3638The prompt mentions the file(s) or the marker, as appropriate.
3639
3640If there is a `*' in COMMAND, surrounded by whitespace, this runs
3641COMMAND just once with the entire file list substituted there.
3642
3643If there is no `*', but there is a `?' in COMMAND, surrounded by
3644whitespace, this runs COMMAND on each file individually with the
3645file name substituted for `?'.
3646
3647Otherwise, this runs COMMAND on each file individually with the
3648file name added at the end of COMMAND (separated by a space).
3649
3650`*' and `?' when not surrounded by whitespace have no special
3651significance for `dired-do-shell-command', and are passed through
3652normally to the shell, but you must confirm first. To pass `*' by
3653itself to the shell as a wildcard, type `*\"\"'.
3654
3655If COMMAND produces output, it goes to a separate buffer.
3656
3657This feature does not try to redisplay Dired buffers afterward, as
3658there's no telling what files COMMAND may have changed.
3659Type \\[dired-do-redisplay] to redisplay the marked files.
3660
5a0c3f56
JB
3661When COMMAND runs, its working directory is the top-level directory
3662of the Dired buffer, so output files usually are created there
3663instead of in a subdir.
7d72f6f1
GM
3664
3665In a noninteractive call (from Lisp code), you must specify
3666the list of file names explicitly with the FILE-LIST argument, which
3667can be produced by `dired-get-marked-files', for example.
3668
3669\(fn COMMAND &optional ARG FILE-LIST)" t nil)
3670
3671(autoload 'dired-run-shell-command "dired-aux" "\
3672Not documented
3673
3674\(fn COMMAND)" nil nil)
3675
3676(autoload 'dired-do-kill-lines "dired-aux" "\
3677Kill all marked lines (not the files).
3678With a prefix argument, kill that many lines starting with the current line.
3679\(A negative argument kills backward.)
3680If you use this command with a prefix argument to kill the line
3681for a file that is a directory, which you have inserted in the
3682Dired buffer as a subdirectory, then it deletes that subdirectory
3683from the buffer as well.
3684To kill an entire subdirectory (without killing its line in the
3685parent directory), go to its directory header line and use this
3686command with a prefix argument (the value does not matter).
3687
3688\(fn &optional ARG FMT)" t nil)
3689
3690(autoload 'dired-compress-file "dired-aux" "\
3691Not documented
3692
3693\(fn FILE)" nil nil)
3694
3695(autoload 'dired-query "dired-aux" "\
e36ead70
JB
3696Query user and return nil or t.
3697Store answer in symbol VAR (which must initially be bound to nil).
3698Format PROMPT with ARGS.
3699Binding variable `help-form' will help the user who types the help key.
7d72f6f1
GM
3700
3701\(fn QS-VAR QS-PROMPT &rest QS-ARGS)" nil nil)
3702
3703(autoload 'dired-do-compress "dired-aux" "\
3704Compress or uncompress marked (or next ARG) files.
3705
3706\(fn &optional ARG)" t nil)
3707
3708(autoload 'dired-do-byte-compile "dired-aux" "\
3709Byte compile marked (or next ARG) Emacs Lisp files.
3710
3711\(fn &optional ARG)" t nil)
3712
3713(autoload 'dired-do-load "dired-aux" "\
3714Load the marked (or next ARG) Emacs Lisp files.
3715
3716\(fn &optional ARG)" t nil)
3717
3718(autoload 'dired-do-redisplay "dired-aux" "\
3719Redisplay all marked (or next ARG) files.
3720If on a subdir line, redisplay that subdirectory. In that case,
3721a prefix arg lets you edit the `ls' switches used for the new listing.
3722
3723Dired remembers switches specified with a prefix arg, so that reverting
3724the buffer will not reset them. However, using `dired-undo' to re-insert
3725or delete subdirectories can bypass this machinery. Hence, you sometimes
3726may have to reset some subdirectory switches after a `dired-undo'.
3727You can reset all subdirectory switches to the default using
3728\\<dired-mode-map>\\[dired-reset-subdir-switches].
3729See Info node `(emacs)Subdir switches' for more details.
3730
3731\(fn &optional ARG TEST-FOR-SUBDIR)" t nil)
3732
3733(autoload 'dired-add-file "dired-aux" "\
3734Not documented
3735
3736\(fn FILENAME &optional MARKER-CHAR)" nil nil)
3737
3738(autoload 'dired-remove-file "dired-aux" "\
3739Not documented
3740
3741\(fn FILE)" nil nil)
3742
3743(autoload 'dired-relist-file "dired-aux" "\
3744Create or update the line for FILE in all Dired buffers it would belong in.
3745
3746\(fn FILE)" nil nil)
3747
3748(autoload 'dired-copy-file "dired-aux" "\
3749Not documented
3750
3751\(fn FROM TO OK-FLAG)" nil nil)
3752
3753(autoload 'dired-rename-file "dired-aux" "\
3754Not documented
3755
3756\(fn FILE NEWNAME OK-IF-ALREADY-EXISTS)" nil nil)
3757
3758(autoload 'dired-create-directory "dired-aux" "\
3759Create a directory called DIRECTORY.
3760
3761\(fn DIRECTORY)" t nil)
3762
3763(autoload 'dired-do-copy "dired-aux" "\
3764Copy all marked (or next ARG) files, or copy the current file.
3765This normally preserves the last-modified date when copying.
3766When operating on just the current file, you specify the new name.
3767When operating on multiple or marked files, you specify a directory,
3768and new copies of these files are made in that directory
3769with the same names that the files currently have. The default
3770suggested for the target directory depends on the value of
3771`dired-dwim-target', which see.
3772
3773This command copies symbolic links by creating new ones,
3774like `cp -d'.
3775
3776\(fn &optional ARG)" t nil)
3777
3778(autoload 'dired-do-symlink "dired-aux" "\
3779Make symbolic links to current file or all marked (or next ARG) files.
3780When operating on just the current file, you specify the new name.
3781When operating on multiple or marked files, you specify a directory
3782and new symbolic links are made in that directory
3783with the same names that the files currently have. The default
3784suggested for the target directory depends on the value of
3785`dired-dwim-target', which see.
3786
3787For relative symlinks, use \\[dired-do-relsymlink].
3788
3789\(fn &optional ARG)" t nil)
3790
3791(autoload 'dired-do-hardlink "dired-aux" "\
3792Add names (hard links) current file or all marked (or next ARG) files.
3793When operating on just the current file, you specify the new name.
3794When operating on multiple or marked files, you specify a directory
3795and new hard links are made in that directory
3796with the same names that the files currently have. The default
3797suggested for the target directory depends on the value of
3798`dired-dwim-target', which see.
3799
3800\(fn &optional ARG)" t nil)
3801
3802(autoload 'dired-do-rename "dired-aux" "\
3803Rename current file or all marked (or next ARG) files.
3804When renaming just the current file, you specify the new name.
3805When renaming multiple or marked files, you specify a directory.
3806This command also renames any buffers that are visiting the files.
3807The default suggested for the target directory depends on the value
3808of `dired-dwim-target', which see.
3809
3810\(fn &optional ARG)" t nil)
3811
3812(autoload 'dired-do-rename-regexp "dired-aux" "\
3813Rename selected files whose names match REGEXP to NEWNAME.
3814
3815With non-zero prefix argument ARG, the command operates on the next ARG
3816files. Otherwise, it operates on all the marked files, or the current
3817file if none are marked.
3818
3819As each match is found, the user must type a character saying
3820 what to do with it. For directions, type \\[help-command] at that time.
3821NEWNAME may contain \\=\\<n> or \\& as in `query-replace-regexp'.
3822REGEXP defaults to the last regexp used.
3823
3824With a zero prefix arg, renaming by regexp affects the absolute file name.
3825Normally, only the non-directory part of the file name is used and changed.
3826
3827\(fn REGEXP NEWNAME &optional ARG WHOLE-NAME)" t nil)
3828
3829(autoload 'dired-do-copy-regexp "dired-aux" "\
3830Copy selected files whose names match REGEXP to NEWNAME.
3831See function `dired-do-rename-regexp' for more info.
3832
3833\(fn REGEXP NEWNAME &optional ARG WHOLE-NAME)" t nil)
3834
3835(autoload 'dired-do-hardlink-regexp "dired-aux" "\
3836Hardlink selected files whose names match REGEXP to NEWNAME.
3837See function `dired-do-rename-regexp' for more info.
3838
3839\(fn REGEXP NEWNAME &optional ARG WHOLE-NAME)" t nil)
3840
3841(autoload 'dired-do-symlink-regexp "dired-aux" "\
3842Symlink selected files whose names match REGEXP to NEWNAME.
3843See function `dired-do-rename-regexp' for more info.
3844
3845\(fn REGEXP NEWNAME &optional ARG WHOLE-NAME)" t nil)
3846
3847(autoload 'dired-upcase "dired-aux" "\
3848Rename all marked (or next ARG) files to upper case.
3849
3850\(fn &optional ARG)" t nil)
3851
3852(autoload 'dired-downcase "dired-aux" "\
3853Rename all marked (or next ARG) files to lower case.
3854
3855\(fn &optional ARG)" t nil)
3856
3857(autoload 'dired-maybe-insert-subdir "dired-aux" "\
3858Insert this subdirectory into the same dired buffer.
3859If it is already present, just move to it (type \\[dired-do-redisplay] to refresh),
3860 else inserts it at its natural place (as `ls -lR' would have done).
3861With a prefix arg, you may edit the ls switches used for this listing.
3862 You can add `R' to the switches to expand the whole tree starting at
3863 this subdirectory.
3864This function takes some pains to conform to `ls -lR' output.
3865
3866Dired remembers switches specified with a prefix arg, so that reverting
3867the buffer will not reset them. However, using `dired-undo' to re-insert
3868or delete subdirectories can bypass this machinery. Hence, you sometimes
3869may have to reset some subdirectory switches after a `dired-undo'.
3870You can reset all subdirectory switches to the default using
3871\\<dired-mode-map>\\[dired-reset-subdir-switches].
3872See Info node `(emacs)Subdir switches' for more details.
3873
3874\(fn DIRNAME &optional SWITCHES NO-ERROR-IF-NOT-DIR-P)" t nil)
3875
3876(autoload 'dired-insert-subdir "dired-aux" "\
3877Insert this subdirectory into the same dired buffer.
3878If it is already present, overwrites previous entry,
3879 else inserts it at its natural place (as `ls -lR' would have done).
3880With a prefix arg, you may edit the `ls' switches used for this listing.
3881 You can add `R' to the switches to expand the whole tree starting at
3882 this subdirectory.
3883This function takes some pains to conform to `ls -lR' output.
3884
3885\(fn DIRNAME &optional SWITCHES NO-ERROR-IF-NOT-DIR-P)" t nil)
3886
3887(autoload 'dired-prev-subdir "dired-aux" "\
3888Go to previous subdirectory, regardless of level.
3889When called interactively and not on a subdir line, go to this subdir's line.
3890
3891\(fn ARG &optional NO-ERROR-IF-NOT-FOUND NO-SKIP)" t nil)
3892
3893(autoload 'dired-goto-subdir "dired-aux" "\
3894Go to end of header line of DIR in this dired buffer.
3895Return value of point on success, otherwise return nil.
3896The next char is either \\n, or \\r if DIR is hidden.
3897
3898\(fn DIR)" t nil)
3899
3900(autoload 'dired-mark-subdir-files "dired-aux" "\
3901Mark all files except `.' and `..' in current subdirectory.
3902If the Dired buffer shows multiple directories, this command
3903marks the files listed in the subdirectory that point is in.
3904
3905\(fn)" t nil)
3906
3907(autoload 'dired-kill-subdir "dired-aux" "\
3908Remove all lines of current subdirectory.
3909Lower levels are unaffected.
3910
3911\(fn &optional REMEMBER-MARKS)" t nil)
3912
3913(autoload 'dired-tree-up "dired-aux" "\
3914Go up ARG levels in the dired tree.
3915
3916\(fn ARG)" t nil)
3917
3918(autoload 'dired-tree-down "dired-aux" "\
3919Go down in the dired tree.
3920
3921\(fn)" t nil)
3922
3923(autoload 'dired-hide-subdir "dired-aux" "\
3924Hide or unhide the current subdirectory and move to next directory.
3925Optional prefix arg is a repeat factor.
3926Use \\[dired-hide-all] to (un)hide all directories.
3927
3928\(fn ARG)" t nil)
3929
3930(autoload 'dired-hide-all "dired-aux" "\
3931Hide all subdirectories, leaving only their header lines.
3932If there is already something hidden, make everything visible again.
3933Use \\[dired-hide-subdir] to (un)hide a particular subdirectory.
3934
8ae41cbc 3935\(fn &optional IGNORED)" t nil)
7d72f6f1
GM
3936
3937(autoload 'dired-isearch-filenames-setup "dired-aux" "\
3938Set up isearch to search in Dired file names.
3939Intended to be added to `isearch-mode-hook'.
3940
3941\(fn)" nil nil)
3942
3943(autoload 'dired-isearch-filenames "dired-aux" "\
3944Search for a string using Isearch only in file names in the Dired buffer.
3945
3946\(fn)" t nil)
3947
3948(autoload 'dired-isearch-filenames-regexp "dired-aux" "\
3949Search for a regexp using Isearch only in file names in the Dired buffer.
3950
3951\(fn)" t nil)
3952
3953(autoload 'dired-do-isearch "dired-aux" "\
3954Search for a string through all marked files using Isearch.
3955
3956\(fn)" t nil)
3957
3958(autoload 'dired-do-isearch-regexp "dired-aux" "\
3959Search for a regexp through all marked files using Isearch.
3960
3961\(fn)" t nil)
3962
3963(autoload 'dired-do-search "dired-aux" "\
3964Search through all marked files for a match for REGEXP.
3965Stops when a match is found.
3966To continue searching for next match, use command \\[tags-loop-continue].
3967
3968\(fn REGEXP)" t nil)
3969
3970(autoload 'dired-do-query-replace-regexp "dired-aux" "\
3971Do `query-replace-regexp' of FROM with TO, on all marked files.
3972Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
3973If you exit (\\[keyboard-quit], RET or q), you can resume the query replace
3974with the command \\[tags-loop-continue].
3975
3976\(fn FROM TO &optional DELIMITED)" t nil)
3977
3978(autoload 'dired-show-file-type "dired-aux" "\
3979Print the type of FILE, according to the `file' command.
3980If FILE is a symbolic link and the optional argument DEREF-SYMLINKS is
3981true then the type of the file linked to by FILE is printed instead.
3982
3983\(fn FILE &optional DEREF-SYMLINKS)" t nil)
3984
3985;;;***
3986\f
3987;;;### (autoloads (dired-do-relsymlink dired-jump) "dired-x" "dired-x.el"
f5d6548a 3988;;;;;; "6c492aba3ca0d36a4cd7b02fb9c1cc10")
7d72f6f1
GM
3989;;; Generated autoloads from dired-x.el
3990
3991(autoload 'dired-jump "dired-x" "\
3992Jump to dired buffer corresponding to current buffer.
3993If in a file, dired the current directory and move to file's line.
3994If in Dired already, pop up a level and goto old directory's line.
3995In case the proper dired file line cannot be found, refresh the dired
3996buffer and try again.
f5d6548a
JL
3997When OTHER-WINDOW is non-nil, jump to dired buffer in other window.
3998Interactively with prefix argument, read FILE-NAME and
3999move to its line in dired.
7d72f6f1 4000
f5d6548a 4001\(fn &optional OTHER-WINDOW FILE-NAME)" t nil)
7d72f6f1
GM
4002
4003(autoload 'dired-do-relsymlink "dired-x" "\
4004Relative symlink all marked (or next ARG) files into a directory.
4005Otherwise make a relative symbolic link to the current file.
4006This creates relative symbolic links like
4007
4008 foo -> ../bar/foo
4009
4010not absolute ones like
4011
4012 foo -> /ugly/file/name/that/may/change/any/day/bar/foo
4013
4014For absolute symlinks, use \\[dired-do-symlink].
4015
4016\(fn &optional ARG)" t nil)
4017
4018;;;***
4019\f
4020;;; End of automatically extracted autoloads.
4021
52041219
RS
4022(provide 'dired)
4023
57e15005
BF
4024(run-hooks 'dired-load-hook) ; for your customizations
4025
87ae59e3 4026;; arch-tag: e1af7a8f-691c-41a0-aac1-ddd4d3c87517
52041219 4027;;; dired.el ends here