Mercurial > emacs
comparison lisp/dired-aux.el @ 724:fb86b8eef4e5
Initial revision
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Wed, 24 Jun 1992 02:14:18 +0000 |
parents | |
children | 2598c08c91c2 |
comparison
equal
deleted
inserted
replaced
723:a898ba10b49c | 724:fb86b8eef4e5 |
---|---|
1 ;; DIRED commands for Emacs. $Revision: 5.234 $ | |
2 ;; Copyright (C) 1985, 1986, 1992 Free Software Foundation, Inc. | |
3 | |
4 ;; This file is part of GNU Emacs. | |
5 | |
6 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
7 ;; it under the terms of the GNU General Public License as published by | |
8 ;; the Free Software Foundation; either version 1, or (at your option) | |
9 ;; any later version. | |
10 | |
11 ;; GNU Emacs is distributed in the hope that it will be useful, | |
12 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 ;; GNU General Public License for more details. | |
15 | |
16 ;; You should have received a copy of the GNU General Public License | |
17 ;; along with GNU Emacs; see the file COPYING. If not, write to | |
18 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. | |
19 | |
20 ;; Rewritten in 1990/1991 to add tree features, file marking and | |
21 ;; sorting by Sebastian Kremer <sk@thp.uni-koeln.de>. | |
22 ;; Finished up by rms in 1992. | |
23 | |
24 ;;; 15K | |
25 ;;;###begin dired-cmd.el | |
26 ;; Diffing and compressing | |
27 | |
28 ;;;###autoload | |
29 (defun dired-diff (file &optional switches) | |
30 "Compare file at point with file FILE using `diff'. | |
31 FILE defaults to the file at the mark. | |
32 The prompted-for file is the first file given to `diff'. | |
33 Prefix arg lets you edit the diff switches. See the command `diff'." | |
34 (interactive | |
35 (let ((default (if (mark) | |
36 (save-excursion (goto-char (mark)) | |
37 (dired-get-filename t t))))) | |
38 (list (read-file-name (format "Diff %s with: %s" | |
39 (dired-get-filename t) | |
40 (if default | |
41 (concat "(default " default ") ") | |
42 "")) | |
43 (dired-current-directory) default t) | |
44 (if (fboundp 'diff-read-switches) | |
45 (diff-read-switches "Options for diff: "))))) | |
46 (if switches ; Emacs 19's diff has but two | |
47 (diff file (dired-get-filename t) switches) ; args (yet ;-) | |
48 (diff file (dired-get-filename t)))) | |
49 | |
50 ;;;###autoload | |
51 (defun dired-backup-diff (&optional switches) | |
52 "Diff this file with its backup file or vice versa. | |
53 Uses the latest backup, if there are several numerical backups. | |
54 If this file is a backup, diff it with its original. | |
55 The backup file is the first file given to `diff'. | |
56 Prefix arg lets you edit the diff switches. See the command `diff'." | |
57 (interactive (list (if (fboundp 'diff-read-switches) | |
58 (diff-read-switches "Diff with switches: ")))) | |
59 (let (bak ori (file (dired-get-filename))) | |
60 (if (backup-file-name-p file) | |
61 (setq bak file | |
62 ori (file-name-sans-versions file)) | |
63 (setq bak (or (dired-latest-backup-file file) | |
64 (error "No backup found for %s" file)) | |
65 ori file)) | |
66 (if switches | |
67 (diff bak ori switches) | |
68 (diff bak ori)))) | |
69 | |
70 (defun dired-latest-backup-file (fn) ; actually belongs into files.el | |
71 "Return the latest existing backup of FILE, or nil." | |
72 ;; First try simple backup, then the highest numbered of the | |
73 ;; numbered backups. | |
74 ;; Ignore the value of version-control because we look for existing | |
75 ;; backups, which maybe were made earlier or by another user with | |
76 ;; a different value of version-control. | |
77 (setq fn (expand-file-name fn)) | |
78 (or | |
79 (let ((bak (make-backup-file-name fn))) | |
80 (if (file-exists-p bak) bak)) | |
81 (let* ((dir (file-name-directory fn)) | |
82 (base-versions (concat (file-name-nondirectory fn) ".~")) | |
83 (bv-length (length base-versions))) | |
84 (concat dir | |
85 (car (sort | |
86 (file-name-all-completions base-versions dir) | |
87 ;; bv-length is a fluid var for backup-extract-version: | |
88 (function | |
89 (lambda (fn1 fn2) | |
90 (> (backup-extract-version fn1) | |
91 (backup-extract-version fn2)))))))))) | |
92 | |
93 (defun dired-do-chxxx (attribute-name program op-symbol arg) | |
94 ;; Change file attributes (mode, group, owner) of marked files and | |
95 ;; refresh their file lines. | |
96 ;; ATTRIBUTE-NAME is a string describing the attribute to the user. | |
97 ;; PROGRAM is the program used to change the attribute. | |
98 ;; OP-SYMBOL is the type of operation (for use in dired-mark-pop-up). | |
99 ;; ARG describes which files to use, as in dired-get-marked-files. | |
100 (let* ((files (dired-get-marked-files t arg)) | |
101 (new-attribute | |
102 (dired-mark-read-string | |
103 (concat "Change " attribute-name " of %s to: ") | |
104 nil op-symbol arg files)) | |
105 (operation (concat program " " new-attribute)) | |
106 failures) | |
107 (setq failures | |
108 (dired-bunch-files 10000 | |
109 (function dired-check-process) | |
110 (list operation program new-attribute) | |
111 files)) | |
112 (dired-do-redisplay arg);; moves point if ARG is an integer | |
113 (if failures | |
114 (dired-log-summary | |
115 (format "%s: error" operation) | |
116 nil)))) | |
117 | |
118 ;;;###autoload | |
119 (defun dired-do-chmod (&optional arg) | |
120 "Change the mode of the marked (or next ARG) files. | |
121 This calls chmod, thus symbolic modes like `g+w' are allowed." | |
122 (interactive "P") | |
123 (dired-do-chxxx "Mode" "chmod" 'chmod arg)) | |
124 | |
125 ;;;###autoload | |
126 (defun dired-do-chgrp (&optional arg) | |
127 "Change the group of the marked (or next ARG) files." | |
128 (interactive "P") | |
129 (dired-do-chxxx "Group" "chgrp" 'chgrp arg)) | |
130 | |
131 ;;;###autoload | |
132 (defun dired-do-chown (&optional arg) | |
133 "Change the owner of the marked (or next ARG) files." | |
134 (interactive "P") | |
135 (dired-do-chxxx "Owner" dired-chown-program 'chown arg)) | |
136 | |
137 ;; Process all the files in FILES in batches of a convenient size, | |
138 ;; by means of (FUNCALL FUNCTION ARGS... SOME-FILES...). | |
139 ;; Batches are chosen to need less than MAX chars for the file names, | |
140 ;; allowing 3 extra characters of separator per file name. | |
141 (defun dired-bunch-files (max function args files) | |
142 (let (pending | |
143 (pending-length 0) | |
144 failures) | |
145 ;; Accumulate files as long as they fit in MAX chars, | |
146 ;; then process the ones accumulated so far. | |
147 (while files | |
148 (let* ((thisfile (car files)) | |
149 (thislength (+ (length thisfile) 3)) | |
150 (rest (cdr files))) | |
151 ;; If we have at least 1 pending file | |
152 ;; and this file won't fit in the length limit, process now. | |
153 (if (and pending (> (+ thislength pending-length) max)) | |
154 (setq failures | |
155 (nconc (apply function (append args pending) pending) | |
156 failures) | |
157 pending nil | |
158 pending-length 0)) | |
159 ;; Do (setq pending (cons thisfile pending)) | |
160 ;; but reuse the cons that was in `files'. | |
161 (setcdr files pending) | |
162 (setq pending files) | |
163 (setq pending-length (+ thislength pending-length)) | |
164 (setq files rest))) | |
165 (nconc (apply function (append args pending) pending) | |
166 failures))) | |
167 | |
168 ;;;###autoload | |
169 (defun dired-do-print (&optional arg) | |
170 "Print the marked (or next ARG) files. | |
171 Uses the shell command coming from variables `lpr-command' and | |
172 `lpr-switches' as default." | |
173 (interactive "P") | |
174 (let* ((file-list (dired-get-marked-files t arg)) | |
175 (command (dired-mark-read-string | |
176 "Print %s with: " | |
177 (apply 'concat lpr-command " " lpr-switches) | |
178 'print arg file-list))) | |
179 (dired-run-shell-command (dired-shell-stuff-it command file-list nil)))) | |
180 | |
181 ;; Read arguments for a marked-files command that wants a string | |
182 ;; that is not a file name, | |
183 ;; perhaps popping up the list of marked files. | |
184 ;; ARG is the prefix arg and indicates whether the files came from | |
185 ;; marks (ARG=nil) or a repeat factor (integerp ARG). | |
186 ;; If the current file was used, the list has but one element and ARG | |
187 ;; does not matter. (It is non-nil, non-integer in that case, namely '(4)). | |
188 | |
189 (defun dired-mark-read-string (prompt initial op-symbol arg files) | |
190 ;; PROMPT for a string, with INITIAL input. | |
191 ;; Other args are used to give user feedback and pop-up: | |
192 ;; OP-SYMBOL of command, prefix ARG, marked FILES. | |
193 (dired-mark-pop-up | |
194 nil op-symbol files | |
195 (function read-string) | |
196 (format prompt (dired-mark-prompt arg files)) initial)) | |
197 | |
198 ;;; Shell commands | |
199 ;;>>> install (move this function into simple.el) | |
200 (defun dired-shell-quote (filename) | |
201 "Quote a file name for inferior shell (see variable `shell-file-name')." | |
202 ;; Quote everything except POSIX filename characters. | |
203 ;; This should be safe enough even for really wierd shells. | |
204 (let ((result "") (start 0) end) | |
205 (while (string-match "[^---0-9a-zA-Z_./]" filename start) | |
206 (setq end (match-beginning 0) | |
207 result (concat result (substring filename start end) | |
208 "\\" (substring filename end (1+ end))) | |
209 start (1+ end))) | |
210 (concat result (substring filename start)))) | |
211 | |
212 (defun dired-read-shell-command (prompt arg files) | |
213 ;; "Read a dired shell command prompting with PROMPT (using read-string). | |
214 ;;ARG is the prefix arg and may be used to indicate in the prompt which | |
215 ;; files are affected. | |
216 ;;This is an extra function so that you can redefine it, e.g., to use gmhist." | |
217 (dired-mark-pop-up | |
218 nil 'shell files | |
219 (function read-string) | |
220 (format prompt (dired-mark-prompt arg files)))) | |
221 | |
222 ;; The in-background argument is only needed in Emacs 18 where | |
223 ;; shell-command doesn't understand an appended ampersand `&'. | |
224 ;;;###autoload | |
225 (defun dired-do-shell-command (&optional arg in-background) | |
226 "Run a shell command on the marked files. | |
227 If there is output, it goes to a separate buffer. | |
228 Normally the command is run on each file individually. | |
229 However, if there is a `*' in the command then it is run | |
230 just once with the entire file list substituted there. | |
231 | |
232 If no files are marked or a specific numeric prefix arg is given, | |
233 the next ARG files are used. Just \\[universal-argument] means the current file. | |
234 The prompt mentions the file(s) or the marker, as appropriate. | |
235 | |
236 No automatic redisplay is attempted, as the file names may have | |
237 changed. Type \\[dired-do-redisplay] to redisplay the marked files. | |
238 | |
239 The shell command has the top level directory as working directory, so | |
240 output files usually are created there instead of in a subdir." | |
241 ;;Functions dired-run-shell-command and dired-shell-stuff-it do the | |
242 ;;actual work and can be redefined for customization. | |
243 (interactive "P") | |
244 (let* ((on-each (not (string-match "\\*" command))) | |
245 (prompt (concat (if in-background "& on " "! on ") | |
246 (if on-each "each " "") | |
247 "%s: ")) | |
248 (file-list (dired-get-marked-files t arg)) | |
249 ;; Want to give feedback whether this file or marked files are used: | |
250 (command (dired-read-shell-command | |
251 prompt arg file-list))) | |
252 (if on-each | |
253 (dired-bunch-files | |
254 (- 10000 (length command)) | |
255 (function (lambda (&rest files) | |
256 (dired-run-shell-command | |
257 (dired-shell-stuff-it command files t arg)) | |
258 in-background)) | |
259 nil | |
260 file-list) | |
261 ;; execute the shell command | |
262 (dired-run-shell-command | |
263 (dired-shell-stuff-it command file-list nil arg) | |
264 in-background)))) | |
265 | |
266 ;; Might use {,} for bash or csh: | |
267 (defvar dired-mark-prefix "" | |
268 "Prepended to marked files in dired shell commands.") | |
269 (defvar dired-mark-postfix "" | |
270 "Appended to marked files in dired shell commands.") | |
271 (defvar dired-mark-separator " " | |
272 "Separates marked files in dired shell commands.") | |
273 | |
274 (defun dired-shell-stuff-it (command file-list on-each &optional raw-arg) | |
275 ;; "Make up a shell command line from COMMAND and FILE-LIST. | |
276 ;; If ON-EACH is t, COMMAND should be applied to each file, else | |
277 ;; simply concat all files and apply COMMAND to this. | |
278 ;; FILE-LIST's elements will be quoted for the shell." | |
279 ;; Might be redefined for smarter things and could then use RAW-ARG | |
280 ;; (coming from interactive P and currently ignored) to decide what to do. | |
281 ;; Smart would be a way to access basename or extension of file names. | |
282 ;; See dired-trns.el for an approach to this. | |
283 ;; Bug: There is no way to quote a * | |
284 ;; On the other hand, you can never accidentally get a * into your cmd. | |
285 (let ((stuff-it | |
286 (if (string-match "\\*" command) | |
287 (function (lambda (x) | |
288 (dired-replace-in-string "\\*" x command))) | |
289 (function (lambda (x) (concat command " " x)))))) | |
290 (if on-each | |
291 (mapconcat stuff-it (mapcar 'dired-shell-quote file-list) ";") | |
292 (let ((fns (mapconcat 'dired-shell-quote | |
293 file-list dired-mark-separator))) | |
294 (if (> (length file-list) 1) | |
295 (setq fns (concat dired-mark-prefix fns dired-mark-postfix))) | |
296 (funcall stuff-it fns))))) | |
297 | |
298 ;; This is an extra function so that it can be redefined by ange-ftp. | |
299 (defun dired-run-shell-command (command &optional in-background) | |
300 (if (not in-background) | |
301 (shell-command command) | |
302 ;; We need this only in Emacs 18 (19's shell command has `&'). | |
303 ;; comint::background is defined in emacs-19.el. | |
304 (comint::background command))) | |
305 | |
306 ;; In Emacs 19 this will return program's exit status. | |
307 ;; This is a separate function so that ange-ftp can redefine it. | |
308 (defun dired-call-process (program discard &rest arguments) | |
309 ; "Run PROGRAM with output to current buffer unless DISCARD is t. | |
310 ;Remaining arguments are strings passed as command arguments to PROGRAM." | |
311 (apply 'call-process program nil (not discard) nil arguments)) | |
312 | |
313 (defun dired-check-process (msg program &rest arguments) | |
314 ; "Display MSG while running PROGRAM, and check for output. | |
315 ;Remaining arguments are strings passed as command arguments to PROGRAM. | |
316 ; On error, insert output | |
317 ; in a log buffer and return the offending ARGUMENTS or PROGRAM. | |
318 ; Caller can cons up a list of failed args. | |
319 ;Else returns nil for success." | |
320 (let (err-buffer err (dir default-directory)) | |
321 (message "%s..." msg) | |
322 (save-excursion | |
323 ;; Get a clean buffer for error output: | |
324 (setq err-buffer (get-buffer-create " *dired-check-process output*")) | |
325 (set-buffer err-buffer) | |
326 (erase-buffer) | |
327 (setq default-directory dir ; caller's default-directory | |
328 err (/= 0 | |
329 (apply (function dired-call-process) program nil arguments))) | |
330 (if err | |
331 (progn | |
332 (dired-log (concat program " " (prin1-to-string arguments) "\n")) | |
333 (dired-log err-buffer) | |
334 (or arguments program t)) | |
335 (kill-buffer err-buffer) | |
336 (message "%s...done" msg) | |
337 nil)))) | |
338 | |
339 ;; Commands that delete or redisplay part of the dired buffer. | |
340 | |
341 ;;;###autoload | |
342 (defun dired-kill-line-or-subdir (&optional arg) | |
343 "Kill this line (but don't delete its file). | |
344 Optional prefix argument is a repeat factor. | |
345 If file is displayed as in situ subdir, kill that as well. | |
346 If on a subdir headerline, kill whole subdir." | |
347 (interactive "p") | |
348 (if (dired-get-subdir) | |
349 (dired-kill-subdir) | |
350 (dired-kill-line arg))) | |
351 | |
352 (defun dired-kill-line (&optional arg) | |
353 (interactive "P") | |
354 (setq arg (prefix-numeric-value arg)) | |
355 (let (buffer-read-only file) | |
356 (while (/= 0 arg) | |
357 (setq file (dired-get-filename nil t)) | |
358 (if (not file) | |
359 (error "Can only kill file lines.") | |
360 (save-excursion (and file | |
361 (dired-goto-subdir file) | |
362 (dired-kill-subdir))) | |
363 (delete-region (progn (beginning-of-line) (point)) | |
364 (progn (forward-line 1) (point))) | |
365 (if (> arg 0) | |
366 (setq arg (1- arg)) | |
367 (setq arg (1+ arg)) | |
368 (forward-line -1)))) | |
369 (dired-move-to-filename))) | |
370 | |
371 ;;;###autoload | |
372 (defun dired-do-kill-lines (&optional arg fmt) | |
373 "Kill all marked lines (not the files). | |
374 With a prefix arg, kill all lines not marked or flagged." | |
375 ;; Returns count of killed lines. FMT="" suppresses message. | |
376 (interactive "P") | |
377 (save-excursion | |
378 (goto-char (point-min)) | |
379 (let (buffer-read-only (count 0)) | |
380 (if (not arg) ; kill marked lines | |
381 (let ((regexp (dired-marker-regexp))) | |
382 (while (and (not (eobp)) | |
383 (re-search-forward regexp nil t)) | |
384 (setq count (1+ count)) | |
385 (delete-region (progn (beginning-of-line) (point)) | |
386 (progn (forward-line 1) (point))))) | |
387 ;; else kill unmarked lines | |
388 (while (not (eobp)) | |
389 (if (or (dired-between-files) | |
390 (not (looking-at "^ "))) | |
391 (forward-line 1) | |
392 (setq count (1+ count)) | |
393 (delete-region (point) (save-excursion | |
394 (forward-line 1) | |
395 (point)))))) | |
396 (or (equal "" fmt) | |
397 (message (or fmt "Killed %d line%s.") count (dired-plural-s count))) | |
398 count))) | |
399 | |
400 ;;;###end dired-cmd.el | |
401 | |
402 ;;; 30K | |
403 ;;;###begin dired-cp.el | |
404 | |
405 (defun dired-compress () | |
406 ;; Compress or uncompress the current file. | |
407 ;; Return nil for success, offending filename else. | |
408 (let* (buffer-read-only | |
409 (from-file (dired-get-filename))) | |
410 (cond ((save-excursion (beginning-of-line) | |
411 (looking-at dired-re-sym)) | |
412 (dired-log (concat "Attempt to compress a symbolic link:\n" | |
413 from-file)) | |
414 (dired-make-relative from-file)) | |
415 ((string-match "\\.Z$" from-file) | |
416 (if (dired-check-process (concat "Uncompressing " from-file) | |
417 "uncompress" from-file) | |
418 (dired-make-relative from-file) | |
419 (dired-update-file-line (substring from-file 0 -2)))) | |
420 (t | |
421 (if (dired-check-process (concat "Compressing " from-file) | |
422 "compress" "-f" from-file) | |
423 ;; Errors from the process are already logged. | |
424 (dired-make-relative from-file) | |
425 (dired-update-file-line (concat from-file ".Z"))))) | |
426 nil)) | |
427 | |
428 (defun dired-mark-confirm (op-symbol arg) | |
429 ;; Request confirmation from the user that the operation described | |
430 ;; by OP-SYMBOL is to be performed on the marked files. | |
431 ;; Confirmation consists in a y-or-n question with a file list | |
432 ;; pop-up unless OP-SYMBOL is a member of `dired-no-confirm'. | |
433 ;; The files used are determined by ARG (as in dired-get-marked-files). | |
434 (or (memq op-symbol dired-no-confirm) | |
435 (let ((files (dired-get-marked-files t arg))) | |
436 (dired-mark-pop-up nil op-symbol files (function y-or-n-p) | |
437 (concat (capitalize (symbol-name op-symbol)) " " | |
438 (dired-mark-prompt arg files) "? "))))) | |
439 | |
440 (defun dired-map-over-marks-check (fun arg op-symbol &optional show-progress) | |
441 ; "Map FUN over marked files (with second ARG like in dired-map-over-marks) | |
442 ; and display failures. | |
443 | |
444 ; FUN takes zero args. It returns non-nil (the offending object, e.g. | |
445 ; the short form of the filename) for a failure and probably logs a | |
446 ; detailed error explanation using function `dired-log'. | |
447 | |
448 ; OP-SYMBOL is a symbol describing the operation performed (e.g. | |
449 ; `compress'). It is used with `dired-mark-pop-up' to prompt the user | |
450 ; (e.g. with `Compress * [2 files]? ') and to display errors (e.g. | |
451 ; `Failed to compress 1 of 2 files - type W to see why ("foo")') | |
452 | |
453 ; SHOW-PROGRESS if non-nil means redisplay dired after each file." | |
454 (if (dired-mark-confirm op-symbol arg) | |
455 (let* ((total-list;; all of FUN's return values | |
456 (dired-map-over-marks (funcall fun) arg show-progress)) | |
457 (total (length total-list)) | |
458 (failures (delq nil total-list)) | |
459 (count (length failures))) | |
460 (if (not failures) | |
461 (message "%s: %d file%s." | |
462 (capitalize (symbol-name op-symbol)) | |
463 total (dired-plural-s total)) | |
464 ;; end this bunch of errors: | |
465 (dired-log-summary | |
466 (format "Failed to %s %d of %d file%s" | |
467 (symbol-name op-symbol) count total (dired-plural-s total)) | |
468 failures))))) | |
469 | |
470 (defvar dired-query-alist | |
471 '((?\y . y) (?\040 . y) ; `y' or SPC means accept once | |
472 (?n . n) (?\177 . n) ; `n' or DEL skips once | |
473 (?! . yes) ; `!' accepts rest | |
474 (?q. no) (?\e . no) ; `q' or ESC skips rest | |
475 ;; None of these keys quit - use C-g for that. | |
476 )) | |
477 | |
478 (defun dired-query (qs-var qs-prompt &rest qs-args) | |
479 ;; Query user and return nil or t. | |
480 ;; Store answer in symbol VAR (which must initially be bound to nil). | |
481 ;; Format PROMPT with ARGS. | |
482 ;; Binding variable help-form will help the user who types C-h. | |
483 (let* ((char (symbol-value qs-var)) | |
484 (action (cdr (assoc char dired-query-alist)))) | |
485 (cond ((eq 'yes action) | |
486 t) ; accept, and don't ask again | |
487 ((eq 'no action) | |
488 nil) ; skip, and don't ask again | |
489 (t;; no lasting effects from last time we asked - ask now | |
490 (let ((qprompt (concat qs-prompt | |
491 (if help-form | |
492 (format " [Type yn!q or %s] " | |
493 (key-description | |
494 (char-to-string help-char))) | |
495 " [Type y, n, q or !] "))) | |
496 result elt) | |
497 ;; Actually it looks nicer without cursor-in-echo-area - you can | |
498 ;; look at the dired buffer instead of at the prompt to decide. | |
499 (apply 'message qprompt qs-args) | |
500 (setq char (set qs-var (read-char))) | |
501 (while (not (setq elt (assoc char dired-query-alist))) | |
502 (message "Invalid char - type %c for help." help-char) | |
503 (ding) | |
504 (sit-for 1) | |
505 (apply 'message qprompt qs-args) | |
506 (setq char (set qs-var (read-char)))) | |
507 (memq (cdr elt) '(t y yes))))))) | |
508 | |
509 ;;;###autoload | |
510 (defun dired-do-compress (&optional arg) | |
511 "Compress or uncompress marked (or next ARG) files." | |
512 (interactive "P") | |
513 (dired-map-over-marks-check (function dired-compress) arg 'compress t)) | |
514 | |
515 ;; Commands for Emacs Lisp files - load and byte compile | |
516 | |
517 (defun dired-byte-compile () | |
518 ;; Return nil for success, offending file name else. | |
519 (let* ((filename (dired-get-filename)) | |
520 (elc-file | |
521 (if (eq system-type 'vax-vms) | |
522 (concat (substring filename 0 (string-match ";" filename)) "c") | |
523 (concat filename "c"))) | |
524 buffer-read-only failure) | |
525 (condition-case err | |
526 (save-excursion (byte-compile-file filename)) | |
527 (error | |
528 (setq failure err))) | |
529 (if failure | |
530 (progn | |
531 (dired-log "Byte compile error for %s:\n%s\n" filename failure) | |
532 (dired-make-relative filename)) | |
533 (dired-remove-file elc-file) | |
534 (forward-line) ; insert .elc after its .el file | |
535 (dired-add-file elc-file) | |
536 nil))) | |
537 | |
538 ;;;###autoload | |
539 (defun dired-do-byte-compile (&optional arg) | |
540 "Byte compile marked (or next ARG) Emacs Lisp files." | |
541 (interactive "P") | |
542 (dired-map-over-marks-check (function dired-byte-compile) arg 'byte-compile t)) | |
543 | |
544 (defun dired-load () | |
545 ;; Return nil for success, offending file name else. | |
546 (let ((file (dired-get-filename)) failure) | |
547 (condition-case err | |
548 (load file nil nil t) | |
549 (error (setq failure err))) | |
550 (if (not failure) | |
551 nil | |
552 (dired-log "Load error for %s:\n%s\n" file failure) | |
553 (dired-make-relative file)))) | |
554 | |
555 ;;;###autoload | |
556 (defun dired-do-load (&optional arg) | |
557 "Load the marked (or next ARG) Emacs Lisp files." | |
558 (interactive "P") | |
559 (dired-map-over-marks-check (function dired-load) arg 'load t)) | |
560 | |
561 ;;;###autoload | |
562 (defun dired-do-redisplay (&optional arg test-for-subdir) | |
563 "Redisplay all marked (or next ARG) files. | |
564 If on a subdir line, redisplay that subdirectory. In that case, | |
565 a prefix arg lets you edit the `ls' switches used for the new listing." | |
566 ;; Moves point if the next ARG files are redisplayed. | |
567 (interactive "P\np") | |
568 (if (and test-for-subdir (dired-get-subdir)) | |
569 (dired-insert-subdir | |
570 (dired-get-subdir) | |
571 (if arg (read-string "Switches for listing: " dired-actual-switches))) | |
572 (message "Redisplaying...") | |
573 ;; message much faster than making dired-map-over-marks show progress | |
574 (dired-map-over-marks (let ((fname (dired-get-filename))) | |
575 (message "Redisplaying... %s" fname) | |
576 (dired-update-file-line fname)) | |
577 arg) | |
578 (dired-move-to-filename) | |
579 (message "Redisplaying...done"))) | |
580 | |
581 (defun dired-update-file-line (file) | |
582 ;; Delete the current line, and insert an entry for FILE. | |
583 ;; If FILE is nil, then just delete the current line. | |
584 ;; Keeps any marks that may be present in column one (doing this | |
585 ;; here is faster than with dired-add-entry's optional arg). | |
586 ;; Does not update other dired buffers. Use dired-relist-entry for that. | |
587 (beginning-of-line) | |
588 (let ((char (following-char)) (opoint (point))) | |
589 (delete-region (point) (progn (forward-line 1) (point))) | |
590 (if file | |
591 (progn | |
592 (dired-add-entry file) | |
593 ;; Replace space by old marker without moving point. | |
594 ;; Faster than goto+insdel inside a save-excursion? | |
595 (subst-char-in-region opoint (1+ opoint) ?\040 char)))) | |
596 (dired-move-to-filename)) | |
597 | |
598 (defun dired-fun-in-all-buffers (directory fun &rest args) | |
599 ;; In all buffers dired'ing DIRECTORY, run FUN with ARGS. | |
600 ;; Return list of buffers where FUN succeeded (i.e., returned non-nil). | |
601 (let ((buf-list (dired-buffers-for-dir directory)) | |
602 (obuf (current-buffer)) | |
603 buf success-list) | |
604 (while buf-list | |
605 (setq buf (car buf-list) | |
606 buf-list (cdr buf-list)) | |
607 (unwind-protect | |
608 (progn | |
609 (set-buffer buf) | |
610 (if (apply fun args) | |
611 (setq success-list (cons (buffer-name buf) success-list)))) | |
612 (set-buffer obuf))) | |
613 success-list)) | |
614 | |
615 (defun dired-add-file (filename &optional marker-char) | |
616 (dired-fun-in-all-buffers | |
617 (file-name-directory filename) | |
618 (function dired-add-entry) filename marker-char)) | |
619 | |
620 (defun dired-add-entry (filename &optional marker-char) | |
621 ;; Add a new entry for FILENAME, optionally marking it | |
622 ;; with MARKER-CHAR (a character, else dired-marker-char is used). | |
623 ;; Note that this adds the entry `out of order' if files sorted by | |
624 ;; time, etc. | |
625 ;; At least this version inserts in the right subdirectory (if present). | |
626 ;; And it skips "." or ".." (see `dired-trivial-filenames'). | |
627 ;; Hidden subdirs are exposed if a file is added there. | |
628 (setq filename (directory-file-name filename)) | |
629 ;; Entry is always for files, even if they happen to also be directories | |
630 (let ((opoint (point)) | |
631 (cur-dir (dired-current-directory)) | |
632 (directory (file-name-directory filename)) | |
633 reason) | |
634 (setq filename (file-name-nondirectory filename) | |
635 reason | |
636 (catch 'not-found | |
637 (if (string= directory cur-dir) | |
638 (progn | |
639 (skip-chars-forward "^\r\n") | |
640 (if (eq (following-char) ?\r) | |
641 (dired-unhide-subdir)) | |
642 ;; We are already where we should be, except when | |
643 ;; point is before the subdir line or its total line. | |
644 (let ((p (dired-after-subdir-garbage cur-dir))) | |
645 (if (< (point) p) | |
646 (goto-char p)))) | |
647 ;; else try to find correct place to insert | |
648 (if (dired-goto-subdir directory) | |
649 (progn;; unhide if necessary | |
650 (if (looking-at "\r");; point is at end of subdir line | |
651 (dired-unhide-subdir)) | |
652 ;; found - skip subdir and `total' line | |
653 ;; and uninteresting files like . and .. | |
654 ;; This better not moves into the next subdir! | |
655 (dired-goto-next-nontrivial-file)) | |
656 ;; not found | |
657 (throw 'not-found "Subdir not found"))) | |
658 ;; found and point is at The Right Place: | |
659 (let (buffer-read-only) | |
660 (beginning-of-line) | |
661 (dired-add-entry-do-indentation marker-char) | |
662 (dired-ls (dired-make-absolute filename directory);; don't expand `.' ! | |
663 (concat dired-actual-switches "d")) | |
664 (forward-line -1) | |
665 ;; We want to have the non-directory part, only: | |
666 (let* ((beg (dired-move-to-filename t)) ; error for strange output | |
667 (end (dired-move-to-end-of-filename))) | |
668 (setq filename (buffer-substring beg end)) | |
669 (delete-region beg end) | |
670 (insert (file-name-nondirectory filename))) | |
671 (if dired-after-readin-hook;; the subdir-alist is not affected... | |
672 (save-excursion;; ...so we can run it right now: | |
673 (save-restriction | |
674 (beginning-of-line) | |
675 (narrow-to-region (point) (save-excursion | |
676 (forward-line 1) (point))) | |
677 (run-hooks 'dired-after-readin-hook)))) | |
678 (dired-move-to-filename)) | |
679 ;; return nil if all went well | |
680 nil)) | |
681 (if reason ; don't move away on failure | |
682 (goto-char opoint)) | |
683 (not reason))) ; return t on succes, nil else | |
684 | |
685 ;; This is a separate function for the sake of nested dired format. | |
686 (defun dired-add-entry-do-indentation (marker-char) | |
687 ;; two spaces or a marker plus a space: | |
688 (insert (if marker-char | |
689 (if (integerp marker-char) marker-char dired-marker-char) | |
690 ?\040) | |
691 ?\040)) | |
692 | |
693 (defun dired-after-subdir-garbage (dir) | |
694 ;; Return pos of first file line of DIR, skipping header and total | |
695 ;; or wildcard lines. | |
696 ;; Important: never moves into the next subdir. | |
697 ;; DIR is assumed to be unhidden. | |
698 ;; Will probably be redefined for VMS etc. | |
699 (save-excursion | |
700 (or (dired-goto-subdir dir) (error "This cannot happen")) | |
701 (forward-line 1) | |
702 (while (and (not (eolp)) ; don't cross subdir boundary | |
703 (not (dired-move-to-filename))) | |
704 (forward-line 1)) | |
705 (point))) | |
706 | |
707 (defun dired-remove-file (file) | |
708 (dired-fun-in-all-buffers | |
709 (file-name-directory file) (function dired-remove-entry) file)) | |
710 | |
711 (defun dired-remove-entry (file) | |
712 (save-excursion | |
713 (and (dired-goto-file file) | |
714 (let (buffer-read-only) | |
715 (delete-region (progn (beginning-of-line) (point)) | |
716 (save-excursion (forward-line 1) (point))))))) | |
717 | |
718 (defun dired-relist-file (file) | |
719 (dired-fun-in-all-buffers (file-name-directory file) | |
720 (function dired-relist-entry) file)) | |
721 | |
722 (defun dired-relist-entry (file) | |
723 ;; Relist the line for FILE, or just add it if it did not exist. | |
724 ;; FILE must be an absolute pathname. | |
725 (let (buffer-read-only marker) | |
726 ;; If cursor is already on FILE's line delete-region will cause | |
727 ;; save-excursion to fail because of floating makers, | |
728 ;; moving point to beginning of line. Sigh. | |
729 (save-excursion | |
730 (and (dired-goto-file file) | |
731 (delete-region (progn (beginning-of-line) | |
732 (setq marker (following-char)) | |
733 (point)) | |
734 (save-excursion (forward-line 1) (point)))) | |
735 (setq file (directory-file-name file)) | |
736 (dired-add-entry file (if (eq ?\040 marker) nil marker))))) | |
737 | |
738 ;;; Copy, move/rename, making hard and symbolic links | |
739 | |
740 (defvar dired-backup-overwrite nil | |
741 "*Non-nil if Dired should ask about making backups before overwriting files. | |
742 Special value `always' suppresses confirmation.") | |
743 | |
744 (defun dired-handle-overwrite (to) | |
745 ;; Save old version of a to be overwritten file TO. | |
746 ;; `overwrite-confirmed' and `overwrite-backup-query' are fluid vars | |
747 ;; from dired-create-files. | |
748 (if (and dired-backup-overwrite | |
749 overwrite-confirmed | |
750 (or (eq 'always dired-backup-overwrite) | |
751 (dired-query 'overwrite-backup-query | |
752 (format "Make backup for existing file `%s'? " to)))) | |
753 (let ((backup (car (find-backup-file-name to)))) | |
754 (rename-file to backup 0) ; confirm overwrite of old backup | |
755 (dired-relist-entry backup)))) | |
756 | |
757 (defun dired-copy-file (from to ok-flag) | |
758 (dired-handle-overwrite to) | |
759 (copy-file from to ok-flag dired-copy-preserve-time)) | |
760 | |
761 (defun dired-rename-file (from to ok-flag) | |
762 (dired-handle-overwrite to) | |
763 (rename-file from to ok-flag) ; error is caught in -create-files | |
764 ;; Silently rename the visited file of any buffer visiting this file. | |
765 (and (get-file-buffer from) | |
766 (save-excursion | |
767 (set-buffer (get-file-buffer from)) | |
768 (let ((modflag (buffer-modified-p))) | |
769 (set-visited-file-name to) | |
770 (set-buffer-modified-p modflag)))) | |
771 (dired-remove-file from) | |
772 ;; See if it's an inserted subdir, and rename that, too. | |
773 (dired-rename-subdir from to)) | |
774 | |
775 (defun dired-rename-subdir (from-dir to-dir) | |
776 (setq from-dir (file-name-as-directory from-dir) | |
777 to-dir (file-name-as-directory to-dir)) | |
778 (dired-fun-in-all-buffers from-dir | |
779 (function dired-rename-subdir-1) from-dir to-dir) | |
780 ;; Update visited file name of all affected buffers | |
781 (let ((blist (buffer-list))) | |
782 (while blist | |
783 (save-excursion | |
784 (set-buffer (car blist)) | |
785 (if (and buffer-file-name | |
786 (dired-in-this-tree buffer-file-name from-dir)) | |
787 (let ((modflag (buffer-modified-p)) | |
788 (to-file (dired-replace-in-string | |
789 (concat "^" (regexp-quote from-dir)) | |
790 to-dir | |
791 buffer-file-name))) | |
792 (set-visited-file-name to-file) | |
793 (set-buffer-modified-p modflag)))) | |
794 (setq blist (cdr blist))))) | |
795 | |
796 (defun dired-rename-subdir-1 (dir to) | |
797 ;; Rename DIR to TO in headerlines and dired-subdir-alist, if DIR or | |
798 ;; one of its subdirectories is expanded in this buffer. | |
799 (let ((alist dired-subdir-alist) | |
800 (elt nil)) | |
801 (while alist | |
802 (setq elt (car alist) | |
803 alist (cdr alist)) | |
804 (if (dired-in-this-tree (car elt) dir) | |
805 ;; ELT's subdir is affected by the rename | |
806 (dired-rename-subdir-2 elt dir to))) | |
807 (if (equal dir default-directory) | |
808 ;; if top level directory was renamed, lots of things have to be | |
809 ;; updated: | |
810 (progn | |
811 (dired-unadvertise dir) ; we no longer dired DIR... | |
812 (setq default-directory to | |
813 dired-directory (expand-file-name;; this is correct | |
814 ;; with and without wildcards | |
815 (file-name-nondirectory dired-directory) | |
816 to)) | |
817 (let ((new-name (file-name-nondirectory | |
818 (directory-file-name dired-directory)))) | |
819 ;; try to rename buffer, but just leave old name if new | |
820 ;; name would already exist (don't try appending "<%d>") | |
821 (or (get-buffer new-name) | |
822 (rename-buffer new-name))) | |
823 ;; ... we dired TO now: | |
824 (dired-advertise))))) | |
825 | |
826 (defun dired-rename-subdir-2 (elt dir to) | |
827 ;; Update the headerline and dired-subdir-alist element of directory | |
828 ;; described by alist-element ELT to reflect the moving of DIR to TO. | |
829 ;; Thus, ELT describes either DIR itself or a subdir of DIR. | |
830 (save-excursion | |
831 (let ((regexp (regexp-quote (directory-file-name dir))) | |
832 (newtext (directory-file-name to)) | |
833 buffer-read-only) | |
834 (goto-char (dired-get-subdir-min elt)) | |
835 ;; Update subdir headerline in buffer | |
836 (if (not (looking-at dired-subdir-regexp)) | |
837 (error "%s not found where expected - dired-subdir-alist broken?" | |
838 dir) | |
839 (goto-char (match-beginning 1)) | |
840 (if (re-search-forward regexp (match-end 1) t) | |
841 (replace-match newtext t t) | |
842 (error "Expected to find `%s' in headerline of %s" dir (car elt)))) | |
843 ;; Update buffer-local dired-subdir-alist | |
844 (setcar elt | |
845 (dired-normalize-subdir | |
846 (dired-replace-in-string regexp newtext (car elt))))))) | |
847 | |
848 ;; Cloning replace-match to work on strings instead of in buffer: | |
849 ;; The FIXEDCASE parameter of replace-match is not implemented. | |
850 ;;;###autoload | |
851 (defun dired-string-replace-match (regexp string newtext | |
852 &optional literal global) | |
853 "Replace first match of REGEXP in STRING with NEWTEXT. | |
854 If it does not match, nil is returned instead of the new string. | |
855 Optional arg LITERAL means to take NEWTEXT literally. | |
856 Optional arg GLOBAL means to replace all matches." | |
857 (if global | |
858 (let ((result "") (start 0) mb me) | |
859 (while (string-match regexp string start) | |
860 (setq mb (match-beginning 0) | |
861 me (match-end 0) | |
862 result (concat result | |
863 (substring string start mb) | |
864 (if literal | |
865 newtext | |
866 (dired-expand-newtext string newtext))) | |
867 start me)) | |
868 (if mb ; matched at least once | |
869 (concat result (substring string start)) | |
870 nil)) | |
871 ;; not GLOBAL | |
872 (if (not (string-match regexp string 0)) | |
873 nil | |
874 (concat (substring string 0 (match-beginning 0)) | |
875 (if literal newtext (dired-expand-newtext string newtext)) | |
876 (substring string (match-end 0)))))) | |
877 | |
878 (defun dired-expand-newtext (string newtext) | |
879 ;; Expand \& and \1..\9 (referring to STRING) in NEWTEXT, using match data. | |
880 ;; Note that in Emacs 18 match data are clipped to current buffer | |
881 ;; size...so the buffer should better not be smaller than STRING. | |
882 (let ((pos 0) | |
883 (len (length newtext)) | |
884 (expanded-newtext "")) | |
885 (while (< pos len) | |
886 (setq expanded-newtext | |
887 (concat expanded-newtext | |
888 (let ((c (aref newtext pos))) | |
889 (if (= ?\\ c) | |
890 (cond ((= ?\& (setq c | |
891 (aref newtext | |
892 (setq pos (1+ pos))))) | |
893 (substring string | |
894 (match-beginning 0) | |
895 (match-end 0))) | |
896 ((and (>= c ?1) (<= c ?9)) | |
897 ;; return empty string if N'th | |
898 ;; sub-regexp did not match: | |
899 (let ((n (- c ?0))) | |
900 (if (match-beginning n) | |
901 (substring string | |
902 (match-beginning n) | |
903 (match-end n)) | |
904 ""))) | |
905 (t | |
906 (char-to-string c))) | |
907 (char-to-string c))))) | |
908 (setq pos (1+ pos))) | |
909 expanded-newtext)) | |
910 | |
911 ;; The basic function for half a dozen variations on cp/mv/ln/ln -s. | |
912 (defun dired-create-files (file-creator operation fn-list name-constructor | |
913 &optional marker-char) | |
914 | |
915 ;; Create a new file for each from a list of existing files. The user | |
916 ;; is queried, dired buffers are updated, and at the end a success or | |
917 ;; failure message is displayed | |
918 | |
919 ;; FILE-CREATOR must accept three args: oldfile newfile ok-if-already-exists | |
920 | |
921 ;; It is called for each file and must create newfile, the entry of | |
922 ;; which will be added. The user will be queried if the file already | |
923 ;; exists. If oldfile is removed by FILE-CREATOR (i.e, it is a | |
924 ;; rename), it is FILE-CREATOR's responsibility to update dired | |
925 ;; buffers. FILE-CREATOR must abort by signalling a file-error if it | |
926 ;; could not create newfile. The error is caught and logged. | |
927 | |
928 ;; OPERATION (a capitalized string, e.g. `Copy') describes the | |
929 ;; operation performed. It is used for error logging. | |
930 | |
931 ;; FN-LIST is the list of files to copy (full absolute pathnames). | |
932 | |
933 ;; NAME-CONSTRUCTOR returns a newfile for every oldfile, or nil to | |
934 ;; skip. If it skips files for other reasons than a direct user | |
935 ;; query, it is supposed to tell why (using dired-log). | |
936 | |
937 ;; Optional MARKER-CHAR is a character with which to mark every | |
938 ;; newfile's entry, or t to use the current marker character if the | |
939 ;; oldfile was marked. | |
940 | |
941 (let (failures skipped (success-count 0) (total (length fn-list))) | |
942 (let (to overwrite-query | |
943 overwrite-backup-query) ; for dired-handle-overwrite | |
944 (mapcar | |
945 (function | |
946 (lambda (from) | |
947 (setq to (funcall name-constructor from)) | |
948 (if (equal to from) | |
949 (progn | |
950 (setq to nil) | |
951 (dired-log "Cannot %s to same file: %s\n" | |
952 (downcase operation) from))) | |
953 (if (not to) | |
954 (setq skipped (cons (dired-make-relative from) skipped)) | |
955 (let* ((overwrite (file-exists-p to)) | |
956 (overwrite-confirmed ; for dired-handle-overwrite | |
957 (and overwrite | |
958 (let ((help-form '(format "\ | |
959 Type SPC or `y' to overwrite file `%s', | |
960 DEL or `n' to skip to next, | |
961 ESC or `q' to not overwrite any of the remaining files, | |
962 `!' to overwrite all remaining files with no more questions." to))) | |
963 (dired-query 'overwrite-query | |
964 "Overwrite `%s'?" to)))) | |
965 ;; must determine if FROM is marked before file-creator | |
966 ;; gets a chance to delete it (in case of a move). | |
967 (actual-marker-char | |
968 (cond ((integerp marker-char) marker-char) | |
969 (marker-char (dired-file-marker from)) ; slow | |
970 (t nil)))) | |
971 (condition-case err | |
972 (progn | |
973 (funcall file-creator from to overwrite-confirmed) | |
974 (if overwrite | |
975 ;; If we get here, file-creator hasn't been aborted | |
976 ;; and the old entry (if any) has to be deleted | |
977 ;; before adding the new entry. | |
978 (dired-remove-file to)) | |
979 (setq success-count (1+ success-count)) | |
980 (message "%s: %d of %d" operation success-count total) | |
981 (dired-add-file to actual-marker-char)) | |
982 (file-error ; FILE-CREATOR aborted | |
983 (progn | |
984 (setq failures (cons (dired-make-relative from) failures)) | |
985 (dired-log "%s `%s' to `%s' failed:\n%s\n" | |
986 operation from to err)))))))) | |
987 fn-list)) | |
988 (cond | |
989 (failures | |
990 (dired-log-summary | |
991 (format "%s failed for %d of %d file%s" | |
992 operation (length failures) total | |
993 (dired-plural-s total)) | |
994 failures)) | |
995 (skipped | |
996 (dired-log-summary | |
997 (format "%s: %d of %d file%s skipped" | |
998 operation (length skipped) total | |
999 (dired-plural-s total)) | |
1000 skipped)) | |
1001 (t | |
1002 (message "%s: %s file%s" | |
1003 operation success-count (dired-plural-s success-count))))) | |
1004 (dired-move-to-filename)) | |
1005 | |
1006 (defun dired-do-create-files (op-symbol file-creator operation arg | |
1007 &optional marker-char op1 | |
1008 how-to) | |
1009 ;; Create a new file for each marked file. | |
1010 ;; Prompts user for target, which is a directory in which to create | |
1011 ;; the new files. Target may be a plain file if only one marked | |
1012 ;; file exists. | |
1013 ;; OP-SYMBOL is the symbol for the operation. Function `dired-mark-pop-up' | |
1014 ;; will determine wether pop-ups are appropriate for this OP-SYMBOL. | |
1015 ;; FILE-CREATOR and OPERATION as in dired-create-files. | |
1016 ;; ARG as in dired-get-marked-files. | |
1017 ;; Optional arg OP1 is an alternate form for OPERATION if there is | |
1018 ;; only one file. | |
1019 ;; Optional arg MARKER-CHAR as in dired-create-files. | |
1020 ;; Optional arg HOW-TO determines how to treat target: | |
1021 ;; If HOW-TO is not given (or nil), and target is a directory, the | |
1022 ;; file(s) are created inside the target directory. If target | |
1023 ;; is not a directory, there must be exactly one marked file, | |
1024 ;; else error. | |
1025 ;; If HOW-TO is t, then target is not modified. There must be | |
1026 ;; exactly one marked file, else error. | |
1027 ;; Else HOW-TO is assumed to be a function of one argument, target, | |
1028 ;; that looks at target and returns a value for the into-dir | |
1029 ;; variable. The function dired-into-dir-with-symlinks is provided | |
1030 ;; for the case (common when creating symlinks) that symbolic | |
1031 ;; links to directories are not to be considered as directories | |
1032 ;; (as file-directory-p would if HOW-TO had been nil). | |
1033 (or op1 (setq op1 operation)) | |
1034 (let* ((fn-list (dired-get-marked-files nil arg)) | |
1035 (fn-count (length fn-list)) | |
1036 (target (expand-file-name | |
1037 (dired-mark-read-file-name | |
1038 (concat (if (= 1 fn-count) op1 operation) " %s to: ") | |
1039 (dired-dwim-target-directory) | |
1040 op-symbol arg (mapcar (function dired-make-relative) fn-list)))) | |
1041 (into-dir (cond ((null how-to) (file-directory-p target)) | |
1042 ((eq how-to t) nil) | |
1043 (t (funcall how-to target))))) | |
1044 (if (and (> fn-count 1) | |
1045 (not into-dir)) | |
1046 (error "Marked %s: target must be a directory: %s" operation target)) | |
1047 ;; rename-file bombs when moving directories unless we do this: | |
1048 (or into-dir (setq target (directory-file-name target))) | |
1049 (dired-create-files | |
1050 file-creator operation fn-list | |
1051 (if into-dir ; target is a directory | |
1052 ;; This function uses fluid vars into-dir and target when called | |
1053 ;; inside dired-create-files: | |
1054 (function (lambda (from) | |
1055 (expand-file-name (file-name-nondirectory from) target))) | |
1056 (function (lambda (from) target))) | |
1057 marker-char))) | |
1058 | |
1059 ;; Read arguments for a marked-files command that wants a file name, | |
1060 ;; perhaps popping up the list of marked files. | |
1061 ;; ARG is the prefix arg and indicates whether the files came from | |
1062 ;; marks (ARG=nil) or a repeat factor (integerp ARG). | |
1063 ;; If the current file was used, the list has but one element and ARG | |
1064 ;; does not matter. (It is non-nil, non-integer in that case, namely '(4)). | |
1065 | |
1066 (defun dired-mark-read-file-name (prompt dir op-symbol arg files) | |
1067 (dired-mark-pop-up | |
1068 nil op-symbol files | |
1069 (function read-file-name) | |
1070 (format prompt (dired-mark-prompt arg files)) dir)) | |
1071 | |
1072 (defun dired-dwim-target-directory () | |
1073 ;; Try to guess which target directory the user may want. | |
1074 ;; If there is a dired buffer displayed in the next window, use | |
1075 ;; its current subdir, else use current subdir of this dired buffer. | |
1076 (let ((this-dir (and (eq major-mode 'dired-mode) | |
1077 (dired-current-directory)))) | |
1078 ;; non-dired buffer may want to profit from this function, e.g. vm-uudecode | |
1079 (if dired-dwim-target | |
1080 (let* ((other-buf (window-buffer (next-window))) | |
1081 (other-dir (save-excursion | |
1082 (set-buffer other-buf) | |
1083 (and (eq major-mode 'dired-mode) | |
1084 (dired-current-directory))))) | |
1085 (or other-dir this-dir)) | |
1086 this-dir))) | |
1087 | |
1088 ;;;###autoload | |
1089 (defun dired-create-directory (directory) | |
1090 "Create a directory called DIRECTORY." | |
1091 (interactive | |
1092 (list (read-file-name "Create directory: " (dired-current-directory)))) | |
1093 (let ((expanded (directory-file-name (expand-file-name directory)))) | |
1094 (make-directory expanded) | |
1095 (dired-add-file expanded) | |
1096 (dired-move-to-filename))) | |
1097 | |
1098 (defun dired-into-dir-with-symlinks (target) | |
1099 (and (file-directory-p target) | |
1100 (not (file-symlink-p target)))) | |
1101 ;; This may not always be what you want, especially if target is your | |
1102 ;; home directory and it happens to be a symbolic link, as is often the | |
1103 ;; case with NFS and automounters. Or if you want to make symlinks | |
1104 ;; into directories that themselves are only symlinks, also quite | |
1105 ;; common. | |
1106 | |
1107 ;; So we don't use this function as value for HOW-TO in | |
1108 ;; dired-do-symlink, which has the minor disadvantage of | |
1109 ;; making links *into* a symlinked-dir, when you really wanted to | |
1110 ;; *overwrite* that symlink. In that (rare, I guess) case, you'll | |
1111 ;; just have to remove that symlink by hand before making your marked | |
1112 ;; symlinks. | |
1113 | |
1114 ;;;###autoload | |
1115 (defun dired-do-copy (&optional arg) | |
1116 "Copy all marked (or next ARG) files, or copy the current file. | |
1117 This normally preserves the last-modified date when copying. | |
1118 When operating on just the current file, you specify the new name. | |
1119 When operating on multiple or marked files, you specify a directory | |
1120 and new symbolic links are made in that directory | |
1121 with the same names that the files currently have." | |
1122 (interactive "P") | |
1123 (dired-do-create-files 'copy (function dired-copy-file) | |
1124 (if dired-copy-preserve-time "Copy [-p]" "Copy") | |
1125 arg dired-keep-marker-copy)) | |
1126 | |
1127 ;;;###autoload | |
1128 (defun dired-do-symlink (&optional arg) | |
1129 "Make symbolic links to current file or all marked (or next ARG) files. | |
1130 When operating on just the current file, you specify the new name. | |
1131 When operating on multiple or marked files, you specify a directory | |
1132 and new symbolic links are made in that directory | |
1133 with the same names that the files currently have." | |
1134 (interactive "P") | |
1135 (dired-do-create-files 'symlink (function make-symbolic-link) | |
1136 "Symlink" arg dired-keep-marker-symlink)) | |
1137 | |
1138 ;;;###autoload | |
1139 (defun dired-do-hardlink (&optional arg) | |
1140 "Add names (hard links) current file or all marked (or next ARG) files. | |
1141 When operating on just the current file, you specify the new name. | |
1142 When operating on multiple or marked files, you specify a directory | |
1143 and new hard links are made in that directory | |
1144 with the same names that the files currently have." | |
1145 (interactive "P") | |
1146 (dired-do-create-files 'hardlink (function add-name-to-file) | |
1147 "Hardlink" arg dired-keep-marker-hardlink)) | |
1148 | |
1149 ;;;###autoload | |
1150 (defun dired-do-rename (&optional arg) | |
1151 "Rename current file or all marked (or next ARG) files. | |
1152 When renaming just the current file, you specify the new name. | |
1153 When renaming multiple or marked files, you specify a directory." | |
1154 (interactive "P") | |
1155 (dired-do-create-files 'move (function dired-rename-file) | |
1156 "Move" arg dired-keep-marker-rename "Rename")) | |
1157 ;;;###end dired-cp.el | |
1158 | |
1159 ;;; 5K | |
1160 ;;;###begin dired-re.el | |
1161 (defun dired-do-create-files-regexp | |
1162 (file-creator operation arg regexp newname &optional whole-path marker-char) | |
1163 ;; Create a new file for each marked file using regexps. | |
1164 ;; FILE-CREATOR and OPERATION as in dired-create-files. | |
1165 ;; ARG as in dired-get-marked-files. | |
1166 ;; Matches each marked file against REGEXP and constructs the new | |
1167 ;; filename from NEWNAME (like in function replace-match). | |
1168 ;; Optional arg WHOLE-PATH means match/replace the whole pathname | |
1169 ;; instead of only the non-directory part of the file. | |
1170 ;; Optional arg MARKER-CHAR as in dired-create-files. | |
1171 (let* ((fn-list (dired-get-marked-files nil arg)) | |
1172 (fn-count (length fn-list)) | |
1173 (operation-prompt (concat operation " `%s' to `%s'?")) | |
1174 (rename-regexp-help-form (format "\ | |
1175 Type SPC or `y' to %s one match, DEL or `n' to skip to next, | |
1176 `!' to %s all remaining matches with no more questions." | |
1177 (downcase operation) | |
1178 (downcase operation))) | |
1179 (regexp-name-constructor | |
1180 ;; Function to construct new filename using REGEXP and NEWNAME: | |
1181 (if whole-path ; easy (but rare) case | |
1182 (function | |
1183 (lambda (from) | |
1184 (let ((to (dired-string-replace-match regexp from newname)) | |
1185 ;; must bind help-form directly around call to | |
1186 ;; dired-query | |
1187 (help-form rename-regexp-help-form)) | |
1188 (if to | |
1189 (and (dired-query 'rename-regexp-query | |
1190 operation-prompt | |
1191 from | |
1192 to) | |
1193 to) | |
1194 (dired-log "%s: %s did not match regexp %s\n" | |
1195 operation from regexp))))) | |
1196 ;; not whole-path, replace non-directory part only | |
1197 (function | |
1198 (lambda (from) | |
1199 (let* ((new (dired-string-replace-match | |
1200 regexp (file-name-nondirectory from) newname)) | |
1201 (to (and new ; nil means there was no match | |
1202 (expand-file-name new | |
1203 (file-name-directory from)))) | |
1204 (help-form rename-regexp-help-form)) | |
1205 (if to | |
1206 (and (dired-query 'rename-regexp-query | |
1207 operation-prompt | |
1208 (dired-make-relative from) | |
1209 (dired-make-relative to)) | |
1210 to) | |
1211 (dired-log "%s: %s did not match regexp %s\n" | |
1212 operation (file-name-nondirectory from) regexp))))))) | |
1213 rename-regexp-query) | |
1214 (dired-create-files | |
1215 file-creator operation fn-list regexp-name-constructor marker-char))) | |
1216 | |
1217 (defun dired-mark-read-regexp (operation) | |
1218 ;; Prompt user about performing OPERATION. | |
1219 ;; Read and return list of: regexp newname arg whole-path. | |
1220 (let* ((whole-path | |
1221 (equal 0 (prefix-numeric-value current-prefix-arg))) | |
1222 (arg | |
1223 (if whole-path nil current-prefix-arg)) | |
1224 (regexp | |
1225 (dired-read-regexp | |
1226 (concat (if whole-path "Path " "") operation " from (regexp): ") | |
1227 dired-flagging-regexp)) | |
1228 (newname | |
1229 (read-string | |
1230 (concat (if whole-path "Path " "") operation " " regexp " to: ")))) | |
1231 (list regexp newname arg whole-path))) | |
1232 | |
1233 ;;;###autoload | |
1234 (defun dired-do-rename-regexp (regexp newname &optional arg whole-path) | |
1235 "Rename marked files containing REGEXP to NEWNAME. | |
1236 As each match is found, the user must type a character saying | |
1237 what to do with it. For directions, type \\[help-command] at that time. | |
1238 NEWNAME may contain \\=\\<n> or \\& as in `query-replace-regexp'. | |
1239 REGEXP defaults to the last regexp used. | |
1240 With a zero prefix arg, renaming by regexp affects the complete | |
1241 pathname - usually only the non-directory part of file names is used | |
1242 and changed." | |
1243 (interactive (dired-mark-read-regexp "Rename")) | |
1244 (dired-do-create-files-regexp | |
1245 (function dired-rename-file) | |
1246 "Rename" arg regexp newname whole-path dired-keep-marker-rename)) | |
1247 | |
1248 ;;;###autoload | |
1249 (defun dired-do-copy-regexp (regexp newname &optional arg whole-path) | |
1250 "Copy all marked files containing REGEXP to NEWNAME. | |
1251 See function `dired-rename-regexp' for more info." | |
1252 (interactive (dired-mark-read-regexp "Copy")) | |
1253 (dired-do-create-files-regexp | |
1254 (function dired-copy-file) | |
1255 (if dired-copy-preserve-time "Copy [-p]" "Copy") | |
1256 arg regexp newname whole-path dired-keep-marker-copy)) | |
1257 | |
1258 ;;;###autoload | |
1259 (defun dired-do-hardlink-regexp (regexp newname &optional arg whole-path) | |
1260 "Hardlink all marked files containing REGEXP to NEWNAME. | |
1261 See function `dired-rename-regexp' for more info." | |
1262 (interactive (dired-mark-read-regexp "HardLink")) | |
1263 (dired-do-create-files-regexp | |
1264 (function add-name-to-file) | |
1265 "HardLink" arg regexp newname whole-path dired-keep-marker-hardlink)) | |
1266 | |
1267 ;;;###autoload | |
1268 (defun dired-do-symlink-regexp (regexp newname &optional arg whole-path) | |
1269 "Symlink all marked files containing REGEXP to NEWNAME. | |
1270 See function `dired-rename-regexp' for more info." | |
1271 (interactive (dired-mark-read-regexp "SymLink")) | |
1272 (dired-do-create-files-regexp | |
1273 (function make-symbolic-link) | |
1274 "SymLink" arg regexp newname whole-path dired-keep-marker-symlink)) | |
1275 | |
1276 (defun dired-create-files-non-directory | |
1277 (file-creator basename-constructor operation arg) | |
1278 ;; Perform FILE-CREATOR on the non-directory part of marked files | |
1279 ;; using function BASENAME-CONSTRUCTOR, with query for each file. | |
1280 ;; OPERATION like in dired-create-files, ARG as in dired-get-marked-files. | |
1281 (let (rename-non-directory-query) | |
1282 (dired-create-files | |
1283 file-creator | |
1284 operation | |
1285 (dired-get-marked-files nil arg) | |
1286 (function | |
1287 (lambda (from) | |
1288 (let ((to (concat (file-name-directory from) | |
1289 (funcall basename-constructor | |
1290 (file-name-nondirectory from))))) | |
1291 (and (let ((help-form (format "\ | |
1292 Type SPC or `y' to %s one file, DEL or `n' to skip to next, | |
1293 `!' to %s all remaining matches with no more questions." | |
1294 (downcase operation) | |
1295 (downcase operation)))) | |
1296 (dired-query 'rename-non-directory-query | |
1297 (concat operation " `%s' to `%s'") | |
1298 (dired-make-relative from) | |
1299 (dired-make-relative to))) | |
1300 to)))) | |
1301 dired-keep-marker-rename))) | |
1302 | |
1303 (defun dired-rename-non-directory (basename-constructor operation arg) | |
1304 (dired-create-files-non-directory | |
1305 (function dired-rename-file) | |
1306 basename-constructor operation arg)) | |
1307 | |
1308 ;;;###autoload | |
1309 (defun dired-upcase (&optional arg) | |
1310 "Rename all marked (or next ARG) files to upper case." | |
1311 (interactive "P") | |
1312 (dired-rename-non-directory (function upcase) "Rename upcase" arg)) | |
1313 | |
1314 ;;;###autoload | |
1315 (defun dired-downcase (&optional arg) | |
1316 "Rename all marked (or next ARG) files to lower case." | |
1317 (interactive "P") | |
1318 (dired-rename-non-directory (function downcase) "Rename downcase" arg)) | |
1319 | |
1320 ;;;###end dired-re.el | |
1321 | |
1322 ;;; 13K | |
1323 ;;;###begin dired-ins.el | |
1324 | |
1325 ;;;###autoload | |
1326 (defun dired-maybe-insert-subdir (dirname &optional | |
1327 switches no-error-if-not-dir-p) | |
1328 "Insert this subdirectory into the same dired buffer. | |
1329 If it is already present, just move to it (type \\[dired-do-redisplay] to refresh), | |
1330 else inserts it at its natural place (as `ls -lR' would have done). | |
1331 With a prefix arg, you may edit the ls switches used for this listing. | |
1332 You can add `R' to the switches to expand the whole tree starting at | |
1333 this subdirectory. | |
1334 This function takes some pains to conform to `ls -lR' output." | |
1335 (interactive | |
1336 (list (dired-get-filename) | |
1337 (if current-prefix-arg | |
1338 (read-string "Switches for listing: " dired-actual-switches)))) | |
1339 (let ((opoint (point))) | |
1340 ;; We don't need a marker for opoint as the subdir is always | |
1341 ;; inserted *after* opoint. | |
1342 (setq dirname (file-name-as-directory dirname)) | |
1343 (or (and (not switches) | |
1344 (dired-goto-subdir dirname)) | |
1345 (dired-insert-subdir dirname switches no-error-if-not-dir-p)) | |
1346 ;; Push mark so that it's easy to find back. Do this after the | |
1347 ;; insert message so that the user sees the `Mark set' message. | |
1348 (push-mark opoint))) | |
1349 | |
1350 (defun dired-insert-subdir (dirname &optional switches no-error-if-not-dir-p) | |
1351 "Insert this subdirectory into the same dired buffer. | |
1352 If it is already present, overwrites previous entry, | |
1353 else inserts it at its natural place (as `ls -lR' would have done). | |
1354 With a prefix arg, you may edit the `ls' switches used for this listing. | |
1355 You can add `R' to the switches to expand the whole tree starting at | |
1356 this subdirectory. | |
1357 This function takes some pains to conform to `ls -lR' output." | |
1358 ;; NO-ERROR-IF-NOT-DIR-P needed for special filesystems like | |
1359 ;; Prospero where dired-ls does the right thing, but | |
1360 ;; file-directory-p has not been redefined. | |
1361 (interactive | |
1362 (list (dired-get-filename) | |
1363 (if current-prefix-arg | |
1364 (read-string "Switches for listing: " dired-actual-switches)))) | |
1365 (setq dirname (file-name-as-directory (expand-file-name dirname))) | |
1366 (dired-insert-subdir-validate dirname switches) | |
1367 (or no-error-if-not-dir-p | |
1368 (file-directory-p dirname) | |
1369 (error "Attempt to insert a non-directory: %s" dirname)) | |
1370 (let ((elt (assoc dirname dired-subdir-alist)) | |
1371 switches-have-R mark-alist case-fold-search buffer-read-only) | |
1372 ;; case-fold-search is nil now, so we can test for capital `R': | |
1373 (if (setq switches-have-R (and switches (string-match "R" switches))) | |
1374 ;; avoid duplicated subdirs | |
1375 (setq mark-alist (dired-kill-tree dirname t))) | |
1376 (if elt | |
1377 ;; If subdir is already present, remove it and remember its marks | |
1378 (setq mark-alist (nconc (dired-insert-subdir-del elt) mark-alist)) | |
1379 (dired-insert-subdir-newpos dirname)) ; else compute new position | |
1380 (dired-insert-subdir-doupdate | |
1381 dirname elt (dired-insert-subdir-doinsert dirname switches)) | |
1382 (if switches-have-R (dired-build-subdir-alist)) | |
1383 (dired-initial-position dirname) | |
1384 (save-excursion (dired-mark-remembered mark-alist)))) | |
1385 | |
1386 ;; This is a separate function for dired-vms. | |
1387 (defun dired-insert-subdir-validate (dirname &optional switches) | |
1388 ;; Check that it is valid to insert DIRNAME with SWITCHES. | |
1389 ;; Signal an error if invalid (e.g. user typed `i' on `..'). | |
1390 (or (dired-in-this-tree dirname default-directory) | |
1391 (error "%s: not in this directory tree" dirname)) | |
1392 (if switches | |
1393 (let (case-fold-search) | |
1394 (mapcar | |
1395 (function | |
1396 (lambda (x) | |
1397 (or (eq (null (string-match x switches)) | |
1398 (null (string-match x dired-actual-switches))) | |
1399 (error "Can't have dirs with and without -%s switches together" | |
1400 x)))) | |
1401 ;; all switches that make a difference to dired-get-filename: | |
1402 '("F" "b"))))) | |
1403 | |
1404 (defun dired-alist-add (dir new-marker) | |
1405 ;; Add new DIR at NEW-MARKER. Sort alist. | |
1406 (dired-alist-add-1 dir new-marker) | |
1407 (dired-alist-sort)) | |
1408 | |
1409 (defun dired-alist-sort () | |
1410 ;; Keep the alist sorted on buffer position. | |
1411 (setq dired-subdir-alist | |
1412 (sort dired-subdir-alist | |
1413 (function (lambda (elt1 elt2) | |
1414 (> (dired-get-subdir-min elt1) | |
1415 (dired-get-subdir-min elt2))))))) | |
1416 | |
1417 (defun dired-kill-tree (dirname &optional remember-marks) | |
1418 ;;"Kill all proper subdirs of DIRNAME, excluding DIRNAME itself. | |
1419 ;; With optional arg REMEMBER-MARKS, return an alist of marked files." | |
1420 (interactive "DKill tree below directory: ") | |
1421 (let ((s-alist dired-subdir-alist) dir m-alist) | |
1422 (while s-alist | |
1423 (setq dir (car (car s-alist)) | |
1424 s-alist (cdr s-alist)) | |
1425 (if (and (not (string-equal dir dirname)) | |
1426 (dired-in-this-tree dir dirname) | |
1427 (dired-goto-subdir dir)) | |
1428 (setq m-alist (nconc (dired-kill-subdir remember-marks) m-alist)))) | |
1429 m-alist)) | |
1430 | |
1431 (defun dired-insert-subdir-newpos (new-dir) | |
1432 ;; Find pos for new subdir, according to tree order. | |
1433 ;;(goto-char (point-max)) | |
1434 (let ((alist dired-subdir-alist) elt dir pos new-pos) | |
1435 (while alist | |
1436 (setq elt (car alist) | |
1437 alist (cdr alist) | |
1438 dir (car elt) | |
1439 pos (dired-get-subdir-min elt)) | |
1440 (if (dired-tree-lessp dir new-dir) | |
1441 ;; Insert NEW-DIR after DIR | |
1442 (setq new-pos (dired-get-subdir-max elt) | |
1443 alist nil))) | |
1444 (goto-char new-pos)) | |
1445 ;; want a separating newline between subdirs | |
1446 (or (eobp) | |
1447 (forward-line -1)) | |
1448 (insert "\n") | |
1449 (point)) | |
1450 | |
1451 (defun dired-insert-subdir-del (element) | |
1452 ;; Erase an already present subdir (given by ELEMENT) from buffer. | |
1453 ;; Move to that buffer position. Return a mark-alist. | |
1454 (let ((begin-marker (dired-get-subdir-min element))) | |
1455 (goto-char begin-marker) | |
1456 ;; Are at beginning of subdir (and inside it!). Now determine its end: | |
1457 (goto-char (dired-subdir-max)) | |
1458 (or (eobp);; want a separating newline _between_ subdirs: | |
1459 (forward-char -1)) | |
1460 (prog1 | |
1461 (dired-remember-marks begin-marker (point)) | |
1462 (delete-region begin-marker (point))))) | |
1463 | |
1464 (defun dired-insert-subdir-doinsert (dirname switches) | |
1465 ;; Insert ls output after point and put point on the correct | |
1466 ;; position for the subdir alist. | |
1467 ;; Return the boundary of the inserted text (as list of BEG and END). | |
1468 (let ((begin (point)) end) | |
1469 (message "Reading directory %s..." dirname) | |
1470 (let ((dired-actual-switches | |
1471 (or switches | |
1472 (dired-replace-in-string "R" "" dired-actual-switches)))) | |
1473 (if (equal dirname (car (car (reverse dired-subdir-alist)))) | |
1474 ;; top level directory may contain wildcards: | |
1475 (dired-readin-insert dired-directory) | |
1476 (dired-ls dirname dired-actual-switches nil t))) | |
1477 (message "Reading directory %s...done" dirname) | |
1478 (setq end (point-marker)) | |
1479 (indent-rigidly begin end 2) | |
1480 ;; call dired-insert-headerline afterwards, as under VMS dired-ls | |
1481 ;; does insert the headerline itself and the insert function just | |
1482 ;; moves point. | |
1483 ;; Need a marker for END as this inserts text. | |
1484 (goto-char begin) | |
1485 (dired-insert-headerline dirname) | |
1486 ;; point is now like in dired-build-subdir-alist | |
1487 (prog1 | |
1488 (list begin (marker-position end)) | |
1489 (set-marker end nil)))) | |
1490 | |
1491 (defun dired-insert-subdir-doupdate (dirname elt beg-end) | |
1492 ;; Point is at the correct subdir alist position for ELT, | |
1493 ;; BEG-END is the subdir-region (as list of begin and end). | |
1494 (if elt ; subdir was already present | |
1495 ;; update its position (should actually be unchanged) | |
1496 (set-marker (dired-get-subdir-min elt) (point-marker)) | |
1497 (dired-alist-add dirname (point-marker))) | |
1498 ;; The hook may depend on the subdir-alist containing the just | |
1499 ;; inserted subdir, so run it after dired-alist-add: | |
1500 (if dired-after-readin-hook | |
1501 (save-excursion | |
1502 (let ((begin (nth 0 beg-end)) | |
1503 (end (nth 1 beg-end))) | |
1504 (goto-char begin) | |
1505 (save-restriction | |
1506 (narrow-to-region begin end) | |
1507 ;; hook may add or delete lines, but the subdir boundary | |
1508 ;; marker floats | |
1509 (run-hooks 'dired-after-readin-hook)))))) | |
1510 | |
1511 (defun dired-tree-lessp (dir1 dir2) | |
1512 ;; Lexicographic order on pathname components, like `ls -lR': | |
1513 ;; DIR1 < DIR2 iff DIR1 comes *before* DIR2 in an `ls -lR' listing, | |
1514 ;; i.e., iff DIR1 is a (grand)parent dir of DIR2, | |
1515 ;; or DIR1 and DIR2 are in the same parentdir and their last | |
1516 ;; components are string-lessp. | |
1517 ;; Thus ("/usr/" "/usr/bin") and ("/usr/a/" "/usr/b/") are tree-lessp. | |
1518 ;; string-lessp could arguably be replaced by file-newer-than-file-p | |
1519 ;; if dired-actual-switches contained `t'. | |
1520 (setq dir1 (file-name-as-directory dir1) | |
1521 dir2 (file-name-as-directory dir2)) | |
1522 (let ((components-1 (dired-split "/" dir1)) | |
1523 (components-2 (dired-split "/" dir2))) | |
1524 (while (and components-1 | |
1525 components-2 | |
1526 (equal (car components-1) (car components-2))) | |
1527 (setq components-1 (cdr components-1) | |
1528 components-2 (cdr components-2))) | |
1529 (let ((c1 (car components-1)) | |
1530 (c2 (car components-2))) | |
1531 | |
1532 (cond ((and c1 c2) | |
1533 (string-lessp c1 c2)) | |
1534 ((and (null c1) (null c2)) | |
1535 nil) ; they are equal, not lessp | |
1536 ((null c1) ; c2 is a subdir of c1: c1<c2 | |
1537 t) | |
1538 ((null c2) ; c1 is a subdir of c2: c1>c2 | |
1539 nil) | |
1540 (t (error "This can't happen")))))) | |
1541 | |
1542 ;; There should be a builtin split function - inverse to mapconcat. | |
1543 (defun dired-split (pat str &optional limit) | |
1544 "Splitting on regexp PAT, turn string STR into a list of substrings. | |
1545 Optional third arg LIMIT (>= 1) is a limit to the length of the | |
1546 resulting list. | |
1547 Thus, if SEP is a regexp that only matches itself, | |
1548 | |
1549 (mapconcat 'identity (dired-split SEP STRING) SEP) | |
1550 | |
1551 is always equal to STRING." | |
1552 (let* ((start (string-match pat str)) | |
1553 (result (list (substring str 0 start))) | |
1554 (count 1) | |
1555 (end (if start (match-end 0)))) | |
1556 (if end ; else nothing left | |
1557 (while (and (or (not (integerp limit)) | |
1558 (< count limit)) | |
1559 (string-match pat str end)) | |
1560 (setq start (match-beginning 0) | |
1561 count (1+ count) | |
1562 result (cons (substring str end start) result) | |
1563 end (match-end 0) | |
1564 start end) | |
1565 )) | |
1566 (if (and (or (not (integerp limit)) | |
1567 (< count limit)) | |
1568 end) ; else nothing left | |
1569 (setq result | |
1570 (cons (substring str end) result))) | |
1571 (nreverse result))) | |
1572 | |
1573 ;;; moving by subdirectories | |
1574 | |
1575 (defun dired-subdir-index (dir) | |
1576 ;; Return an index into alist for use with nth | |
1577 ;; for the sake of subdir moving commands. | |
1578 (let (found (index 0) (alist dired-subdir-alist)) | |
1579 (while alist | |
1580 (if (string= dir (car (car alist))) | |
1581 (setq alist nil found t) | |
1582 (setq alist (cdr alist) index (1+ index)))) | |
1583 (if found index nil))) | |
1584 | |
1585 ;;;###autoload | |
1586 (defun dired-next-subdir (arg &optional no-error-if-not-found no-skip) | |
1587 "Go to next subdirectory, regardless of level." | |
1588 ;; Use 0 arg to go to this directory's header line. | |
1589 ;; NO-SKIP prevents moving to end of header line, returning whatever | |
1590 ;; position was found in dired-subdir-alist. | |
1591 (interactive "p") | |
1592 (let ((this-dir (dired-current-directory)) | |
1593 pos index) | |
1594 ;; nth with negative arg does not return nil but the first element | |
1595 (setq index (- (dired-subdir-index this-dir) arg)) | |
1596 (setq pos (if (>= index 0) | |
1597 (dired-get-subdir-min (nth index dired-subdir-alist)))) | |
1598 (if pos | |
1599 (progn | |
1600 (goto-char pos) | |
1601 (or no-skip (skip-chars-forward "^\n\r")) | |
1602 (point)) | |
1603 (if no-error-if-not-found | |
1604 nil ; return nil if not found | |
1605 (error "%s directory" (if (> arg 0) "Last" "First")))))) | |
1606 | |
1607 ;;;###autoload | |
1608 (defun dired-prev-subdir (arg &optional no-error-if-not-found no-skip) | |
1609 "Go to previous subdirectory, regardless of level. | |
1610 When called interactively and not on a subdir line, go to this subdir's line." | |
1611 ;;(interactive "p") | |
1612 (interactive | |
1613 (list (if current-prefix-arg | |
1614 (prefix-numeric-value current-prefix-arg) | |
1615 ;; if on subdir start already, don't stay there! | |
1616 (if (dired-get-subdir) 1 0)))) | |
1617 (dired-next-subdir (- arg) no-error-if-not-found no-skip)) | |
1618 | |
1619 (defun dired-subdir-min () | |
1620 (save-excursion | |
1621 (if (not (dired-prev-subdir 0 t t)) | |
1622 (error "Not in a subdir!") | |
1623 (point)))) | |
1624 | |
1625 ;;;###autoload | |
1626 (defun dired-goto-subdir (dir) | |
1627 "Go to end of header line of DIR in this dired buffer. | |
1628 Return value of point on success, otherwise return nil. | |
1629 The next char is either \\n, or \\r if DIR is hidden." | |
1630 (interactive | |
1631 (prog1 ; let push-mark display its message | |
1632 (list (expand-file-name | |
1633 (completing-read "Goto in situ directory: " ; prompt | |
1634 dired-subdir-alist ; table | |
1635 nil ; predicate | |
1636 t ; require-match | |
1637 (dired-current-directory)))) | |
1638 (push-mark))) | |
1639 (setq dir (file-name-as-directory dir)) | |
1640 (let ((elt (assoc dir dired-subdir-alist))) | |
1641 (and elt | |
1642 (goto-char (dired-get-subdir-min elt)) | |
1643 ;; dired-subdir-hidden-p and dired-add-entry depend on point being | |
1644 ;; at either \r or \n after this function succeeds. | |
1645 (progn (skip-chars-forward "^\r\n") | |
1646 (point))))) | |
1647 | |
1648 ;;;###autoload | |
1649 (defun dired-mark-subdir-files () | |
1650 "Mark all files except `.' and `..'." | |
1651 (interactive "P") | |
1652 (let ((p-min (dired-subdir-min))) | |
1653 (dired-mark-files-in-region p-min (dired-subdir-max)))) | |
1654 | |
1655 ;;;###autoload | |
1656 (defun dired-kill-subdir (&optional remember-marks) | |
1657 "Remove all lines of current subdirectory. | |
1658 Lower levels are unaffected." | |
1659 ;; With optional REMEMBER-MARKS, return a mark-alist. | |
1660 (interactive) | |
1661 (let ((beg (dired-subdir-min)) | |
1662 (end (dired-subdir-max)) | |
1663 buffer-read-only cur-dir) | |
1664 (setq cur-dir (dired-current-directory)) | |
1665 (if (equal cur-dir default-directory) | |
1666 (error "Attempt to kill top level directory")) | |
1667 (prog1 | |
1668 (if remember-marks (dired-remember-marks beg end)) | |
1669 (delete-region beg end) | |
1670 (if (eobp) ; don't leave final blank line | |
1671 (delete-char -1)) | |
1672 (dired-unsubdir cur-dir)))) | |
1673 | |
1674 (defun dired-unsubdir (dir) | |
1675 ;; Remove DIR from the alist | |
1676 (setq dired-subdir-alist | |
1677 (delq (assoc dir dired-subdir-alist) dired-subdir-alist))) | |
1678 | |
1679 ;;;###autoload | |
1680 (defun dired-tree-up (arg) | |
1681 "Go up ARG levels in the dired tree." | |
1682 (interactive "p") | |
1683 (let ((dir (dired-current-directory))) | |
1684 (while (>= arg 1) | |
1685 (setq arg (1- arg) | |
1686 dir (file-name-directory (directory-file-name dir)))) | |
1687 ;;(setq dir (expand-file-name dir)) | |
1688 (or (dired-goto-subdir dir) | |
1689 (error "Cannot go up to %s - not in this tree." dir)))) | |
1690 | |
1691 ;;;###autoload | |
1692 (defun dired-tree-down () | |
1693 "Go down in the dired tree." | |
1694 (interactive) | |
1695 (let ((dir (dired-current-directory)) ; has slash | |
1696 pos case-fold-search) ; filenames are case sensitive | |
1697 (let ((rest (reverse dired-subdir-alist)) elt) | |
1698 (while rest | |
1699 (setq elt (car rest) | |
1700 rest (cdr rest)) | |
1701 (if (dired-in-this-tree (directory-file-name (car elt)) dir) | |
1702 (setq rest nil | |
1703 pos (dired-goto-subdir (car elt)))))) | |
1704 (if pos | |
1705 (goto-char pos) | |
1706 (error "At the bottom")))) | |
1707 | |
1708 ;;; hiding | |
1709 | |
1710 (defun dired-unhide-subdir () | |
1711 (let (buffer-read-only) | |
1712 (subst-char-in-region (dired-subdir-min) (dired-subdir-max) ?\r ?\n))) | |
1713 | |
1714 (defun dired-hide-check () | |
1715 (or selective-display | |
1716 (error "selective-display must be t for subdir hiding to work!"))) | |
1717 | |
1718 (defun dired-subdir-hidden-p (dir) | |
1719 (and selective-display | |
1720 (save-excursion | |
1721 (dired-goto-subdir dir) | |
1722 (looking-at "\r")))) | |
1723 | |
1724 ;;;###autoload | |
1725 (defun dired-hide-subdir (arg) | |
1726 "Hide or unhide the current subdirectory and move to next directory. | |
1727 Optional prefix arg is a repeat factor. | |
1728 Use \\[dired-hide-all] to (un)hide all directories." | |
1729 (interactive "p") | |
1730 (dired-hide-check) | |
1731 (while (>= (setq arg (1- arg)) 0) | |
1732 (let* ((cur-dir (dired-current-directory)) | |
1733 (hidden-p (dired-subdir-hidden-p cur-dir)) | |
1734 (elt (assoc cur-dir dired-subdir-alist)) | |
1735 (end-pos (1- (dired-get-subdir-max elt))) | |
1736 buffer-read-only) | |
1737 ;; keep header line visible, hide rest | |
1738 (goto-char (dired-get-subdir-min elt)) | |
1739 (skip-chars-forward "^\n\r") | |
1740 (if hidden-p | |
1741 (subst-char-in-region (point) end-pos ?\r ?\n) | |
1742 (subst-char-in-region (point) end-pos ?\n ?\r))) | |
1743 (dired-next-subdir 1 t))) | |
1744 | |
1745 ;;;###autoload | |
1746 (defun dired-hide-all (arg) | |
1747 "Hide all subdirectories, leaving only their header lines. | |
1748 If there is already something hidden, make everything visible again. | |
1749 Use \\[dired-hide-subdir] to (un)hide a particular subdirectory." | |
1750 (interactive "P") | |
1751 (dired-hide-check) | |
1752 (let (buffer-read-only) | |
1753 (if (save-excursion | |
1754 (goto-char (point-min)) | |
1755 (search-forward "\r" nil t)) | |
1756 ;; unhide - bombs on \r in filenames | |
1757 (subst-char-in-region (point-min) (point-max) ?\r ?\n) | |
1758 ;; hide | |
1759 (let ((pos (point-max)) ; pos of end of last directory | |
1760 (alist dired-subdir-alist)) | |
1761 (while alist ; while there are dirs before pos | |
1762 (subst-char-in-region (dired-get-subdir-min (car alist)) ; pos of prev dir | |
1763 (save-excursion | |
1764 (goto-char pos) ; current dir | |
1765 ;; we're somewhere on current dir's line | |
1766 (forward-line -1) | |
1767 (point)) | |
1768 ?\n ?\r) | |
1769 (setq pos (dired-get-subdir-min (car alist))) ; prev dir gets current dir | |
1770 (setq alist (cdr alist))))))) | |
1771 | |
1772 ;;;###end dired-ins.el |