Commit | Line | Data |
---|---|---|
8c70a2de | 1 | ;;; dired-x.el --- extra Dired functionality -*-byte-compile-dynamic: t;-*- |
cb3fe1f0 RS |
2 | |
3 | ;; Author: Sebastian Kremer <sk@thp.uni-koeln.de> | |
4 | ;; Lawrence R. Dodd <dodd@roebling.poly.edu> | |
749eb401 | 5 | ;; Maintainer: nobody (want to volunteer?) |
9b5ef74b RS |
6 | ;; Version: 2.37+ |
7 | ;; Date: 1994/08/18 19:27:42 | |
a443d46e | 8 | ;; Keywords: dired extensions files |
cb3fe1f0 | 9 | |
0d30b337 TTN |
10 | ;; Copyright (C) 1993, 1994, 1997, 2001, 2002, 2003, 2004, |
11 | ;; 2005 Free Software Foundation, Inc. | |
cb3fe1f0 RS |
12 | |
13 | ;; This file is part of GNU Emacs. | |
14 | ||
15 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
16 | ;; it under the terms of the GNU General Public License as published by | |
de3b6439 | 17 | ;; the Free Software Foundation; either version 2, or (at your option) |
cb3fe1f0 RS |
18 | ;; any later version. |
19 | ||
20 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
21 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
22 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
23 | ;; GNU General Public License for more details. | |
24 | ||
25 | ;; You should have received a copy of the GNU General Public License | |
b578f267 | 26 | ;; along with GNU Emacs; see the file COPYING. If not, write to the |
086add15 LK |
27 | ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
28 | ;; Boston, MA 02110-1301, USA. | |
cb3fe1f0 | 29 | |
9572a9dd | 30 | ;;; Commentary: |
cb3fe1f0 | 31 | |
b578f267 | 32 | ;; This is Sebastian Kremer's excellent dired-x.el (Dired Extra), version |
a443d46e GM |
33 | ;; 1.191, hacked up for GNU Emacs. Redundant or conflicting material has |
34 | ;; been removed or renamed in order to work properly with dired of GNU | |
35 | ;; Emacs. All suggestions or comments are most welcomed. | |
b578f267 | 36 | |
71296446 | 37 | ;; |
b578f267 | 38 | ;; Please, PLEASE, *PLEASE* see the info pages. |
71296446 | 39 | ;; |
b578f267 EN |
40 | |
41 | ;; BUGS: Type M-x dired-x-submit-report and a report will be generated. | |
42 | ||
43 | ;; INSTALLATION: In your ~/.emacs, | |
44 | ;; | |
45 | ;; (add-hook 'dired-load-hook | |
46 | ;; (function (lambda () | |
47 | ;; (load "dired-x") | |
48 | ;; ;; Set global variables here. For example: | |
49 | ;; ;; (setq dired-guess-shell-gnutar "gtar") | |
50 | ;; ))) | |
51 | ;; (add-hook 'dired-mode-hook | |
52 | ;; (function (lambda () | |
53 | ;; ;; Set buffer-local variables here. For example: | |
ce64e046 | 54 | ;; ;; (dired-omit-mode 1) |
b578f267 EN |
55 | ;; ))) |
56 | ;; | |
57 | ;; At load time dired-x.el will install itself, redefine some functions, and | |
58 | ;; bind some dired keys. *Please* see the info pages for more details. | |
59 | ||
b847eb8c | 60 | ;; *Please* see the info pages for more details. |
b578f267 EN |
61 | |
62 | ;; User defined variables: | |
63 | ;; | |
64 | ;; dired-bind-vm | |
65 | ;; dired-vm-read-only-folders | |
66 | ;; dired-bind-jump | |
67 | ;; dired-bind-info | |
68 | ;; dired-bind-man | |
b847eb8c | 69 | ;; dired-x-hands-off-my-keys |
b578f267 EN |
70 | ;; dired-find-subdir |
71 | ;; dired-enable-local-variables | |
72 | ;; dired-local-variables-file | |
73 | ;; dired-guess-shell-gnutar | |
74 | ;; dired-guess-shell-gzip-quiet | |
75 | ;; dired-guess-shell-znew-switches | |
76 | ;; dired-guess-shell-alist-user | |
77 | ;; dired-clean-up-buffers-too | |
ce64e046 | 78 | ;; dired-omit-mode |
b578f267 EN |
79 | ;; dired-omit-files |
80 | ;; dired-omit-extensions | |
ad8c4554 | 81 | ;; dired-omit-size-limit |
b578f267 EN |
82 | ;; |
83 | ;; To find out more about these variables, load this file, put your cursor at | |
84 | ;; the end of any of the variable names, and hit C-h v [RET]. *Please* see | |
85 | ;; the info pages for more details. | |
86 | ||
87 | ;; When loaded this code redefines the following functions of GNU Emacs | |
88 | ;; | |
89 | ;; Function Found in this file of GNU Emacs | |
90 | ;; -------- ------------------------------- | |
91 | ;; dired-clean-up-after-deletion ../lisp/dired.el | |
92 | ;; dired-find-buffer-nocreate ../lisp/dired.el | |
93 | ;; dired-initial-position ../lisp/dired.el | |
94 | ;; | |
95 | ;; dired-add-entry ../lisp/dired-aux.el | |
96 | ;; dired-read-shell-command ../lisp/dired-aux.el | |
cb3fe1f0 RS |
97 | |
98 | \f | |
b578f267 | 99 | ;;; Code: |
cb3fe1f0 | 100 | |
b578f267 | 101 | ;; LOAD. |
cb3fe1f0 | 102 | |
b578f267 EN |
103 | ;; This is a no-op if dired-x is being loaded via `dired-load-hook'. It is |
104 | ;; here in case the user has autoloaded dired-x via the dired-jump key binding | |
105 | ;; (instead of autoloading to dired as is suggested in the info-pages). | |
9572a9dd | 106 | |
d82cfc0c | 107 | (require 'dired) |
9572a9dd | 108 | |
b578f267 EN |
109 | ;; We will redefine some functions and also need some macros so we need to |
110 | ;; load dired stuff of GNU Emacs. | |
d82cfc0c RS |
111 | |
112 | (require 'dired-aux) | |
9572a9dd | 113 | |
12ec3981 JB |
114 | (defvar vm-folder-directory) |
115 | ||
b578f267 | 116 | ;;; User-defined variables. |
cb3fe1f0 | 117 | |
286c247d RS |
118 | (defgroup dired-x nil |
119 | "Extended directory editing (dired-x)." | |
120 | :group 'dired) | |
cb3fe1f0 | 121 | |
286c247d RS |
122 | (defgroup dired-keys nil |
123 | "Dired keys customizations." | |
124 | :prefix "dired-" | |
125 | :group 'dired-x) | |
cb3fe1f0 | 126 | |
286c247d | 127 | (defcustom dired-bind-vm nil |
b847eb8c | 128 | "*Non-nil means \"V\" runs `dired-vm', otherwise \"V\" runs `dired-rmail'. |
286c247d RS |
129 | Also, RMAIL files contain -*- rmail -*- at the top so \"f\", |
130 | `dired-advertised-find-file', will run rmail." | |
131 | :type 'boolean | |
132 | :group 'dired-keys) | |
133 | ||
134 | (defcustom dired-bind-jump t | |
b847eb8c | 135 | "*Non-nil means bind `dired-jump' to C-x C-j, otherwise do not." |
286c247d RS |
136 | :type 'boolean |
137 | :group 'dired-keys) | |
138 | ||
139 | (defcustom dired-bind-man t | |
b847eb8c | 140 | "*Non-nil means bind `dired-man' to \"N\" in dired-mode, otherwise do not." |
286c247d RS |
141 | :type 'boolean |
142 | :group 'dired-keys) | |
143 | ||
144 | (defcustom dired-bind-info t | |
b847eb8c | 145 | "*Non-nil means bind `dired-info' to \"I\" in dired-mode, otherwise do not." |
286c247d RS |
146 | :type 'boolean |
147 | :group 'dired-keys) | |
148 | ||
149 | (defcustom dired-vm-read-only-folders nil | |
b847eb8c | 150 | "*If non-nil, \\[dired-vm] will visit all folders read-only. |
cb3fe1f0 RS |
151 | If neither nil nor t, e.g. the symbol `if-file-read-only', only |
152 | files not writable by you are visited read-only. | |
153 | ||
286c247d RS |
154 | Read-only folders only work in VM 5, not in VM 4." |
155 | :type '(choice (const :tag "off" nil) | |
156 | (const :tag "on" t) | |
e2c146c1 | 157 | (other :tag "non-writable only" if-file-read-only)) |
286c247d | 158 | :group 'dired-x) |
cb3fe1f0 | 159 | |
ce64e046 LH |
160 | (define-minor-mode dired-omit-mode |
161 | "Toggle Dired-Omit mode. | |
162 | With numeric ARG, enable Dired-Omit mode if ARG is positive, disable | |
6fbad7af | 163 | otherwise. Enabling and disabling is buffer-local. |
ce64e046 | 164 | If enabled, \"uninteresting\" files are not listed. |
cb3fe1f0 | 165 | Uninteresting files are those whose filenames match regexp `dired-omit-files', |
286c247d | 166 | plus those ending with extensions in `dired-omit-extensions'." |
ce64e046 LH |
167 | :group 'dired-x |
168 | (if dired-omit-mode | |
169 | ;; This will mention how many lines were omitted: | |
170 | (let ((dired-omit-size-limit nil)) (dired-omit-expunge)) | |
171 | (revert-buffer))) | |
172 | ||
173 | ;; For backward compatibility | |
174 | (defvaralias 'dired-omit-files-p 'dired-omit-mode) | |
175 | (make-obsolete-variable 'dired-omit-files-p 'dired-omit-mode) | |
cb3fe1f0 | 176 | |
99358b97 | 177 | (defcustom dired-omit-files "^\\.?#\\|^\\.$\\|^\\.\\.$" |
e2439696 | 178 | "*Filenames matching this regexp will not be displayed. |
ce64e046 LH |
179 | This only has effect when `dired-omit-mode' is t. See interactive function |
180 | `dired-omit-mode' \(\\[dired-omit-mode]\) and variable | |
99358b97 RS |
181 | `dired-omit-extensions'. The default is to omit `.', `..', auto-save |
182 | files and lock files." | |
286c247d RS |
183 | :type 'regexp |
184 | :group 'dired-x) | |
cb3fe1f0 | 185 | |
286c247d | 186 | (defcustom dired-find-subdir nil ; t is pretty near to DWIM... |
0a44133e RS |
187 | "*If non-nil, Dired always finds a directory in a buffer of its own. |
188 | If nil, Dired finds the directory as a subdirectory in some other buffer | |
189 | if it is present as one. | |
cb3fe1f0 | 190 | |
6fbad7af | 191 | If there are several dired buffers for a directory, the most recently |
cb3fe1f0 RS |
192 | used is chosen. |
193 | ||
194 | Dired avoids switching to the current buffer, so that if you have | |
b847eb8c | 195 | a normal and a wildcard buffer for the same directory, \\[dired] will |
286c247d RS |
196 | toggle between those two." |
197 | :type 'boolean | |
198 | :group 'dired-x) | |
199 | ||
8e458944 | 200 | (defcustom dired-omit-size-limit 30000 |
286c247d RS |
201 | "*Maximum size for the \"omitting\" feature. |
202 | If nil, there is no maximum size." | |
203 | :type '(choice (const :tag "no maximum" nil) integer) | |
204 | :group 'dired-x) | |
cb3fe1f0 | 205 | |
286c247d | 206 | (defcustom dired-enable-local-variables t |
6fbad7af | 207 | "*Control use of local-variables lists in Dired. |
cb3fe1f0 RS |
208 | The value can be t, nil or something else. |
209 | A value of t means local-variables lists are obeyed; | |
210 | nil means they are ignored; anything else means query. | |
211 | ||
212 | This temporarily overrides the value of `enable-local-variables' when listing | |
286c247d RS |
213 | a directory. See also `dired-local-variables-file'." |
214 | :type 'boolean | |
215 | :group 'dired-x) | |
cb3fe1f0 | 216 | |
286c247d | 217 | (defcustom dired-guess-shell-gnutar nil |
b847eb8c DL |
218 | "*If non-nil, name of GNU tar executable. |
219 | \(E.g., \"tar\" or \"gtar\"). The `z' switch will be used with it for | |
220 | compressed or gzip'ed tar files. If you don't have GNU tar, set this | |
286c247d | 221 | to nil: a pipe using `zcat' or `gunzip -c' will be used." |
b847eb8c DL |
222 | :type '(choice (const :tag "Not GNU tar" nil) |
223 | (string :tag "Command name")) | |
286c247d RS |
224 | :group 'dired-x) |
225 | ||
226 | (defcustom dired-guess-shell-gzip-quiet t | |
b847eb8c | 227 | "*Non-nil says pass -q to gzip overriding verbose GZIP environment." |
286c247d RS |
228 | :type 'boolean |
229 | :group 'dired-x) | |
230 | ||
231 | (defcustom dired-guess-shell-znew-switches nil | |
b847eb8c DL |
232 | "*If non-nil, then string of switches passed to `znew', example: \"-K\"." |
233 | :type '(choice (const :tag "None" nil) | |
234 | (string :tag "Switches")) | |
286c247d RS |
235 | :group 'dired-x) |
236 | ||
237 | (defcustom dired-clean-up-buffers-too t | |
6fbad7af | 238 | "*Non-nil means offer to kill buffers visiting files and dirs deleted in Dired." |
286c247d RS |
239 | :type 'boolean |
240 | :group 'dired-x) | |
cb3fe1f0 | 241 | |
b578f267 | 242 | ;;; KEY BINDINGS. |
cb3fe1f0 | 243 | |
ce64e046 | 244 | (define-key dired-mode-map "\M-o" 'dired-omit-mode) |
71326638 | 245 | (define-key dired-mode-map "*O" 'dired-mark-omitted) |
cb3fe1f0 | 246 | (define-key dired-mode-map "\M-(" 'dired-mark-sexp) |
582bd36a RS |
247 | (define-key dired-mode-map "*(" 'dired-mark-sexp) |
248 | (define-key dired-mode-map "*." 'dired-mark-extension) | |
cb3fe1f0 | 249 | (define-key dired-mode-map "\M-!" 'dired-smart-shell-command) |
cb3fe1f0 RS |
250 | (define-key dired-mode-map "w" 'dired-copy-filename-as-kill) |
251 | (define-key dired-mode-map "\M-g" 'dired-goto-file) | |
252 | (define-key dired-mode-map "\M-G" 'dired-goto-subdir) | |
253 | (define-key dired-mode-map "F" 'dired-do-find-marked-files) | |
254 | (define-key dired-mode-map "Y" 'dired-do-relsymlink) | |
255 | (define-key dired-mode-map "%Y" 'dired-do-relsymlink-regexp) | |
256 | (define-key dired-mode-map "V" 'dired-do-run-mail) | |
257 | ||
258 | (if dired-bind-man | |
259 | (define-key dired-mode-map "N" 'dired-man)) | |
260 | ||
261 | (if dired-bind-info | |
262 | (define-key dired-mode-map "I" 'dired-info)) | |
263 | ||
9572a9dd | 264 | ;;; GLOBAL BINDING. |
cb3fe1f0 RS |
265 | (if dired-bind-jump |
266 | (progn | |
267 | (define-key global-map "\C-x\C-j" 'dired-jump) | |
268 | (define-key global-map "\C-x4\C-j" 'dired-jump-other-window))) | |
269 | ||
270 | \f | |
b578f267 | 271 | ;;; Install into appropriate hooks. |
cb3fe1f0 RS |
272 | |
273 | (add-hook 'dired-mode-hook 'dired-extra-startup) | |
274 | (add-hook 'dired-after-readin-hook 'dired-omit-expunge) | |
275 | ||
276 | (defun dired-extra-startup () | |
6fbad7af | 277 | "Automatically put on `dired-mode-hook' to get extra Dired features: |
cb3fe1f0 | 278 | \\<dired-mode-map> |
cb3fe1f0 RS |
279 | \\[dired-do-run-mail]\t-- run mail on folder (see `dired-bind-vm') |
280 | \\[dired-info]\t-- run info on file | |
281 | \\[dired-man]\t-- run man on file | |
282 | \\[dired-do-find-marked-files]\t-- visit all marked files simultaneously | |
ce64e046 | 283 | \\[dired-omit-mode]\t-- toggle omitting of files |
b847eb8c | 284 | \\[dired-mark-sexp]\t-- mark by Lisp expression |
6fbad7af JB |
285 | \\[dired-copy-filename-as-kill]\t-- copy the file or subdir names into the kill ring; |
286 | \t you can feed it to other commands using \\[yank] | |
cb3fe1f0 RS |
287 | |
288 | For more features, see variables | |
289 | ||
b847eb8c DL |
290 | `dired-bind-vm' |
291 | `dired-bind-jump' | |
292 | `dired-bind-info' | |
293 | `dired-bind-man' | |
294 | `dired-vm-read-only-folders' | |
ce64e046 | 295 | `dired-omit-mode' |
b847eb8c DL |
296 | `dired-omit-files' |
297 | `dired-omit-extensions' | |
298 | `dired-omit-size-limit' | |
299 | `dired-find-subdir' | |
300 | `dired-enable-local-variables' | |
301 | `dired-local-variables-file' | |
302 | `dired-guess-shell-gnutar' | |
303 | `dired-guess-shell-gzip-quiet' | |
304 | `dired-guess-shell-znew-switches' | |
305 | `dired-guess-shell-alist-user' | |
306 | `dired-clean-up-buffers-too' | |
cb3fe1f0 RS |
307 | |
308 | See also functions | |
309 | ||
b847eb8c DL |
310 | `dired-flag-extension' |
311 | `dired-virtual' | |
312 | `dired-jump' | |
313 | `dired-man' | |
314 | `dired-vm' | |
315 | `dired-rmail' | |
316 | `dired-info' | |
317 | `dired-do-find-marked-files'" | |
cb3fe1f0 RS |
318 | (interactive) |
319 | ||
320 | ;; These must be done in each new dired buffer. | |
321 | (dired-hack-local-variables) | |
322 | (dired-omit-startup)) | |
323 | ||
324 | \f | |
b578f267 | 325 | ;;; BUFFER CLEANING. |
cb3fe1f0 | 326 | |
b578f267 | 327 | ;; REDEFINE. |
cb3fe1f0 | 328 | (defun dired-clean-up-after-deletion (fn) |
b847eb8c DL |
329 | "Clean up after a deleted file or directory FN. |
330 | Remove expanded subdir of deleted dir, if any." | |
cb3fe1f0 RS |
331 | (save-excursion (and (cdr dired-subdir-alist) |
332 | (dired-goto-subdir fn) | |
333 | (dired-kill-subdir))) | |
334 | ||
335 | ;; Offer to kill buffer of deleted file FN. | |
336 | (if dired-clean-up-buffers-too | |
337 | (progn | |
338 | (let ((buf (get-file-buffer fn))) | |
339 | (and buf | |
340 | (funcall (function y-or-n-p) | |
341 | (format "Kill buffer of %s, too? " | |
342 | (file-name-nondirectory fn))) | |
343 | (save-excursion ; you never know where kill-buffer leaves you | |
344 | (kill-buffer buf)))) | |
12c38283 | 345 | (let ((buf-list (dired-buffers-for-dir (expand-file-name fn))) |
cb3fe1f0 RS |
346 | (buf nil)) |
347 | (and buf-list | |
348 | (y-or-n-p (format "Kill dired buffer%s of %s, too? " | |
349 | (dired-plural-s (length buf-list)) | |
350 | (file-name-nondirectory fn))) | |
351 | (while buf-list | |
352 | (save-excursion (kill-buffer (car buf-list))) | |
353 | (setq buf-list (cdr buf-list))))))) | |
9572a9dd | 354 | ;; Anything else? |
cb3fe1f0 RS |
355 | ) |
356 | ||
357 | \f | |
b578f267 | 358 | ;;; EXTENSION MARKING FUNCTIONS. |
cb3fe1f0 | 359 | |
9572a9dd | 360 | ;;; Mark files with some extension. |
cb3fe1f0 | 361 | (defun dired-mark-extension (extension &optional marker-char) |
b847eb8c | 362 | "Mark all files with a certain EXTENSION for use in later commands. |
6fbad7af | 363 | A `.' is *not* automatically prepended to the string entered." |
cb3fe1f0 RS |
364 | ;; EXTENSION may also be a list of extensions instead of a single one. |
365 | ;; Optional MARKER-CHAR is marker to use. | |
366 | (interactive "sMarking extension: \nP") | |
367 | (or (listp extension) | |
368 | (setq extension (list extension))) | |
369 | (dired-mark-files-regexp | |
370 | (concat ".";; don't match names with nothing but an extension | |
371 | "\\(" | |
372 | (mapconcat 'regexp-quote extension "\\|") | |
373 | "\\)$") | |
374 | marker-char)) | |
375 | ||
376 | (defun dired-flag-extension (extension) | |
b847eb8c | 377 | "In dired, flag all files with a certain EXTENSION for deletion. |
cb3fe1f0 RS |
378 | A `.' is *not* automatically prepended to the string entered." |
379 | (interactive "sFlagging extension: ") | |
380 | (dired-mark-extension extension dired-del-marker)) | |
381 | ||
382 | ;;; Define some unpopular file extensions. Used for cleaning and omitting. | |
383 | ||
384 | (defvar dired-patch-unclean-extensions | |
385 | '(".rej" ".orig") | |
386 | "List of extensions of dispensable files created by the `patch' program.") | |
387 | ||
388 | (defvar dired-tex-unclean-extensions | |
389 | '(".toc" ".log" ".aux");; these are already in completion-ignored-extensions | |
390 | "List of extensions of dispensable files created by TeX.") | |
391 | ||
392 | (defvar dired-latex-unclean-extensions | |
393 | '(".idx" ".lof" ".lot" ".glo") | |
394 | "List of extensions of dispensable files created by LaTeX.") | |
395 | ||
396 | (defvar dired-bibtex-unclean-extensions | |
397 | '(".blg" ".bbl") | |
398 | "List of extensions of dispensable files created by BibTeX.") | |
399 | ||
400 | (defvar dired-texinfo-unclean-extensions | |
401 | '(".cp" ".cps" ".fn" ".fns" ".ky" ".kys" ".pg" ".pgs" | |
402 | ".tp" ".tps" ".vr" ".vrs") | |
403 | "List of extensions of dispensable files created by texinfo.") | |
404 | ||
405 | (defun dired-clean-patch () | |
406 | "Flag dispensable files created by patch for deletion. | |
407 | See variable `dired-patch-unclean-extensions'." | |
408 | (interactive) | |
409 | (dired-flag-extension dired-patch-unclean-extensions)) | |
410 | ||
411 | (defun dired-clean-tex () | |
9572a9dd | 412 | "Flag dispensable files created by [La]TeX etc. for deletion. |
ca388882 | 413 | See variables `dired-tex-unclean-extensions', |
9572a9dd KH |
414 | `dired-latex-unclean-extensions', `dired-bibtex-unclean-extensions' and |
415 | `dired-texinfo-unclean-extensions'." | |
cb3fe1f0 RS |
416 | (interactive) |
417 | (dired-flag-extension (append dired-texinfo-unclean-extensions | |
418 | dired-latex-unclean-extensions | |
419 | dired-bibtex-unclean-extensions | |
420 | dired-tex-unclean-extensions))) | |
421 | ||
9572a9dd KH |
422 | (defun dired-very-clean-tex () |
423 | "Flag dispensable files created by [La]TeX *and* \".dvi\" for deletion. | |
424 | See variables `dired-texinfo-unclean-extensions', | |
425 | `dired-latex-unclean-extensions', `dired-bibtex-unclean-extensions' and | |
426 | `dired-texinfo-unclean-extensions'." | |
cb3fe1f0 | 427 | (interactive) |
9572a9dd KH |
428 | (dired-flag-extension (append dired-texinfo-unclean-extensions |
429 | dired-latex-unclean-extensions | |
430 | dired-bibtex-unclean-extensions | |
431 | dired-tex-unclean-extensions | |
432 | (list ".dvi")))) | |
cb3fe1f0 | 433 | \f |
b578f267 | 434 | ;;; JUMP. |
cb3fe1f0 | 435 | |
40c8b203 | 436 | ;;;###autoload |
cb3fe1f0 RS |
437 | (defun dired-jump (&optional other-window) |
438 | "Jump to dired buffer corresponding to current buffer. | |
439 | If in a file, dired the current directory and move to file's line. | |
6fbad7af | 440 | If in Dired already, pop up a level and goto old directory's line. |
cb3fe1f0 RS |
441 | In case the proper dired file line cannot be found, refresh the dired |
442 | buffer and try again." | |
443 | (interactive "P") | |
444 | (let* ((file buffer-file-name) | |
445 | (dir (if file (file-name-directory file) default-directory))) | |
446 | (if (eq major-mode 'dired-mode) | |
447 | (progn | |
448 | (setq dir (dired-current-directory)) | |
449 | (dired-up-directory other-window) | |
450 | (or (dired-goto-file dir) | |
451 | ;; refresh and try again | |
9572a9dd | 452 | (progn |
cb3fe1f0 RS |
453 | (dired-insert-subdir (file-name-directory dir)) |
454 | (dired-goto-file dir)))) | |
455 | (if other-window | |
456 | (dired-other-window dir) | |
457 | (dired dir)) | |
458 | (if file | |
459 | (or (dired-goto-file file) | |
460 | ;; refresh and try again | |
9572a9dd | 461 | (progn |
cb3fe1f0 | 462 | (dired-insert-subdir (file-name-directory file)) |
7e90bcf5 RS |
463 | (dired-goto-file file)) |
464 | ;; Toggle omitting, if it is on, and try again. | |
ce64e046 | 465 | (if dired-omit-mode |
7e90bcf5 | 466 | (progn |
ce64e046 | 467 | (dired-omit-mode) |
7e90bcf5 | 468 | (dired-goto-file file)))))))) |
cb3fe1f0 RS |
469 | |
470 | (defun dired-jump-other-window () | |
6fbad7af | 471 | "Like \\[dired-jump] (`dired-jump') but in other window." |
cb3fe1f0 RS |
472 | (interactive) |
473 | (dired-jump t)) | |
cb3fe1f0 | 474 | \f |
b578f267 | 475 | ;;; OMITTING. |
cb3fe1f0 RS |
476 | |
477 | ;;; Enhanced omitting of lines from directory listings. | |
478 | ;;; Marked files are never omitted. | |
479 | ||
480 | ;; should probably get rid of this and always use 'no-dir. | |
481 | ;; sk 28-Aug-1991 09:37 | |
482 | (defvar dired-omit-localp 'no-dir | |
b847eb8c | 483 | "The LOCALP argument `dired-omit-expunge' passes to `dired-get-filename'. |
6fbad7af | 484 | If it is `no-dir', omitting is much faster, but you can only match |
470fa6d1 KS |
485 | against the non-directory part of the file name. Set it to nil if you |
486 | need to match the entire file name.") | |
cb3fe1f0 RS |
487 | |
488 | ;; \017=^O for Omit - other packages can chose other control characters. | |
489 | (defvar dired-omit-marker-char ?\017 | |
4cdc09a9 | 490 | "Temporary marker used by dired-omit. |
cb3fe1f0 RS |
491 | Should never be used as marker by the user or other packages.") |
492 | ||
493 | (defun dired-omit-startup () | |
ce64e046 | 494 | (or (assq 'dired-omit-mode minor-mode-alist) |
cb3fe1f0 | 495 | (setq minor-mode-alist |
ce64e046 | 496 | (append '((dired-omit-mode |
ab606888 GM |
497 | (:eval (if (eq major-mode 'dired-mode) |
498 | " Omit" "")))) | |
499 | minor-mode-alist)))) | |
cb3fe1f0 | 500 | |
ce64e046 LH |
501 | (defun dired-mark-omitted () |
502 | "Mark files matching `dired-omit-files' and `dired-omit-extensions'." | |
503 | (interactive) | |
504 | (let ((dired-omit-mode nil)) (revert-buffer)) ;; Show omitted files | |
505 | (dired-mark-unmarked-files (dired-omit-regexp) nil nil dired-omit-localp)) | |
cb3fe1f0 RS |
506 | |
507 | (defvar dired-omit-extensions | |
508 | (append completion-ignored-extensions | |
509 | dired-latex-unclean-extensions | |
510 | dired-bibtex-unclean-extensions | |
511 | dired-texinfo-unclean-extensions) | |
b847eb8c | 512 | "If non-nil, a list of extensions \(strings\) to omit from Dired listings. |
685ff9f8 RS |
513 | Defaults to elements of `completion-ignored-extensions', |
514 | `dired-latex-unclean-extensions', `dired-bibtex-unclean-extensions', and | |
b847eb8c | 515 | `dired-texinfo-unclean-extensions'. |
685ff9f8 | 516 | |
ce64e046 LH |
517 | See interactive function `dired-omit-mode' \(\\[dired-omit-mode]\) and |
518 | variables `dired-omit-mode' and `dired-omit-files'.") | |
cb3fe1f0 RS |
519 | |
520 | (defun dired-omit-expunge (&optional regexp) | |
521 | "Erases all unmarked files matching REGEXP. | |
ce64e046 | 522 | Does nothing if global variable `dired-omit-mode' is nil, or if called |
ad8c4554 | 523 | non-interactively and buffer is bigger than `dired-omit-size-limit'. |
cb3fe1f0 RS |
524 | If REGEXP is nil or not specified, uses `dired-omit-files', and also omits |
525 | filenames ending in `dired-omit-extensions'. | |
526 | If REGEXP is the empty string, this function is a no-op. | |
527 | ||
528 | This functions works by temporarily binding `dired-marker-char' to | |
529 | `dired-omit-marker-char' and calling `dired-do-kill-lines'." | |
530 | (interactive "sOmit files (regexp): ") | |
ce64e046 | 531 | (if (and dired-omit-mode |
ad8c4554 RS |
532 | (or (interactive-p) |
533 | (not dired-omit-size-limit) | |
8e458944 RS |
534 | (< (buffer-size) dired-omit-size-limit) |
535 | (progn | |
536 | (message "Not omitting: directory larger than %d characters." | |
537 | dired-omit-size-limit) | |
ce64e046 | 538 | (setq dired-omit-mode nil) |
8e458944 | 539 | nil))) |
cb3fe1f0 | 540 | (let ((omit-re (or regexp (dired-omit-regexp))) |
9b5ef74b | 541 | (old-modified-p (buffer-modified-p)) |
cb3fe1f0 RS |
542 | count) |
543 | (or (string= omit-re "") | |
544 | (let ((dired-marker-char dired-omit-marker-char)) | |
545 | (message "Omitting...") | |
546 | (if (dired-mark-unmarked-files omit-re nil nil dired-omit-localp) | |
547 | (progn | |
548 | (setq count (dired-do-kill-lines nil "Omitted %d line%s.")) | |
048ea441 | 549 | (force-mode-line-update)) |
cb3fe1f0 | 550 | (message "(Nothing to omit)")))) |
9b5ef74b RS |
551 | ;; Try to preserve modified state of buffer. So `%*' doesn't appear |
552 | ;; in mode-line of omitted buffers. | |
b847eb8c | 553 | (set-buffer-modified-p (and old-modified-p |
9b5ef74b RS |
554 | (save-excursion |
555 | (goto-char (point-min)) | |
556 | (re-search-forward dired-re-mark nil t)))) | |
cb3fe1f0 RS |
557 | count))) |
558 | ||
559 | (defun dired-omit-regexp () | |
560 | (concat (if dired-omit-files (concat "\\(" dired-omit-files "\\)") "") | |
561 | (if (and dired-omit-files dired-omit-extensions) "\\|" "") | |
562 | (if dired-omit-extensions | |
563 | (concat ".";; a non-extension part should exist | |
564 | "\\(" | |
565 | (mapconcat 'regexp-quote dired-omit-extensions "\\|") | |
566 | "\\)$") | |
567 | ""))) | |
568 | ||
569 | ;; Returns t if any work was done, nil otherwise. | |
570 | (defun dired-mark-unmarked-files (regexp msg &optional unflag-p localp) | |
b847eb8c | 571 | "Mark unmarked files matching REGEXP, displaying MSG. |
470fa6d1 | 572 | REGEXP is matched against the entire file name. |
cb3fe1f0 RS |
573 | Does not re-mark files which already have a mark. |
574 | With prefix argument, unflag all those files. | |
6fbad7af | 575 | Optional fourth argument LOCALP is as in `dired-get-filename'." |
cb3fe1f0 | 576 | (interactive "P") |
6fbad7af | 577 | (let ((dired-marker-char (if unflag-p ?\s dired-marker-char))) |
cb3fe1f0 RS |
578 | (dired-mark-if |
579 | (and | |
580 | ;; not already marked | |
581 | (looking-at " ") | |
582 | ;; uninteresting | |
583 | (let ((fn (dired-get-filename localp t))) | |
584 | (and fn (string-match regexp fn)))) | |
585 | msg))) | |
586 | ||
9572a9dd | 587 | ;;; REDEFINE. |
c8225cbe | 588 | (defun dired-omit-new-add-entry (filename &optional marker-char relative) |
cb3fe1f0 RS |
589 | ;; This redefines dired-aux.el's dired-add-entry to avoid calling ls for |
590 | ;; files that are going to be omitted anyway. | |
ce64e046 | 591 | (if dired-omit-mode |
cb3fe1f0 RS |
592 | ;; perhaps return t without calling ls |
593 | (let ((omit-re (dired-omit-regexp))) | |
594 | (if (or (string= omit-re "") | |
595 | (not | |
596 | (string-match omit-re | |
597 | (cond | |
598 | ((eq 'no-dir dired-omit-localp) | |
599 | filename) | |
600 | ((eq t dired-omit-localp) | |
601 | (dired-make-relative filename)) | |
602 | (t | |
603 | (dired-make-absolute | |
604 | filename | |
605 | (file-name-directory filename))))))) | |
606 | ;; if it didn't match, go ahead and add the entry | |
c8225cbe | 607 | (dired-omit-old-add-entry filename marker-char relative) |
cb3fe1f0 RS |
608 | ;; dired-add-entry returns t for success, perhaps we should |
609 | ;; return file-exists-p | |
610 | t)) | |
611 | ;; omitting is not turned on at all | |
c8225cbe | 612 | (dired-omit-old-add-entry filename marker-char relative))) |
cb3fe1f0 | 613 | |
9572a9dd | 614 | ;;; REDEFINE. |
cb3fe1f0 RS |
615 | ;;; Redefine dired-aux.el's version of `dired-add-entry' |
616 | ;;; Save old defun if not already done: | |
617 | (or (fboundp 'dired-omit-old-add-entry) | |
618 | (fset 'dired-omit-old-add-entry (symbol-function 'dired-add-entry))) | |
619 | ;; Redefine it. | |
620 | (fset 'dired-add-entry 'dired-omit-new-add-entry) | |
621 | ||
622 | \f | |
b578f267 | 623 | ;;; VIRTUAL DIRED MODE. |
cb3fe1f0 RS |
624 | |
625 | ;;; For browsing `ls -lR' listings in a dired-like fashion. | |
626 | ||
6fbad7af | 627 | (defalias 'virtual-dired 'dired-virtual) |
cb3fe1f0 RS |
628 | (defun dired-virtual (dirname &optional switches) |
629 | "Put this buffer into Virtual Dired mode. | |
630 | ||
631 | In Virtual Dired mode, all commands that do not actually consult the | |
632 | filesystem will work. | |
633 | ||
634 | This is useful if you want to peruse and move around in an ls -lR | |
635 | output file, for example one you got from an ftp server. With | |
636 | ange-ftp, you can even dired a directory containing an ls-lR file, | |
637 | visit that file and turn on virtual dired mode. But don't try to save | |
638 | this file, as dired-virtual indents the listing and thus changes the | |
639 | buffer. | |
640 | ||
641 | If you have save a Dired buffer in a file you can use \\[dired-virtual] to | |
642 | resume it in a later session. | |
643 | ||
6fbad7af JB |
644 | Type \\<dired-mode-map>\\[revert-buffer] \ |
645 | in the Virtual Dired buffer and answer `y' to convert | |
646 | the virtual to a real dired buffer again. You don't have to do this, though: | |
647 | you can relist single subdirs using \\[dired-do-redisplay]." | |
cb3fe1f0 RS |
648 | |
649 | ;; DIRNAME is the top level directory of the buffer. It will become | |
650 | ;; its `default-directory'. If nil, the old value of | |
651 | ;; default-directory is used. | |
652 | ||
653 | ;; Optional SWITCHES are the ls switches to use. | |
654 | ||
655 | ;; Shell wildcards will be used if there already is a `wildcard' | |
656 | ;; line in the buffer (thus it is a saved Dired buffer), but there | |
657 | ;; is no other way to get wildcards. Insert a `wildcard' line by | |
658 | ;; hand if you want them. | |
659 | ||
660 | (interactive | |
661 | (list (read-string "Virtual Dired directory: " (dired-virtual-guess-dir)))) | |
662 | (goto-char (point-min)) | |
663 | (or (looking-at " ") | |
664 | ;; if not already indented, do it now: | |
665 | (indent-region (point-min) (point-max) 2)) | |
666 | (or dirname (setq dirname default-directory)) | |
667 | (setq dirname (expand-file-name (file-name-as-directory dirname))) | |
668 | (setq default-directory dirname) ; contains no wildcards | |
669 | (let ((wildcard (save-excursion | |
670 | (goto-char (point-min)) | |
671 | (forward-line 1) | |
672 | (and (looking-at "^ wildcard ") | |
673 | (buffer-substring (match-end 0) | |
674 | (progn (end-of-line) (point))))))) | |
675 | (if wildcard | |
676 | (setq dirname (expand-file-name wildcard default-directory)))) | |
677 | ;; If raw ls listing (not a saved old dired buffer), give it a | |
678 | ;; decent subdir headerline: | |
679 | (goto-char (point-min)) | |
680 | (or (looking-at dired-subdir-regexp) | |
fc50a3be MY |
681 | (insert " " |
682 | (directory-file-name (file-name-directory default-directory)) | |
683 | ":\n")) | |
cb3fe1f0 RS |
684 | (dired-mode dirname (or switches dired-listing-switches)) |
685 | (setq mode-name "Virtual Dired" | |
686 | revert-buffer-function 'dired-virtual-revert) | |
687 | (set (make-local-variable 'dired-subdir-alist) nil) | |
688 | (dired-build-subdir-alist) | |
689 | (goto-char (point-min)) | |
690 | (dired-initial-position dirname)) | |
691 | ||
692 | (defun dired-virtual-guess-dir () | |
b847eb8c | 693 | "Guess and return appropriate working directory of this buffer. |
4e6ef391 | 694 | The buffer is assumed to be in Dired or ls -lR format. The guess is |
b847eb8c DL |
695 | based upon buffer contents. If nothing could be guessed, returns |
696 | nil." | |
cb3fe1f0 RS |
697 | |
698 | (let ((regexp "^\\( \\)?\\([^ \n\r]*\\)\\(:\\)[\n\r]") | |
699 | (subexpr 2)) | |
700 | (goto-char (point-min)) | |
701 | (cond ((looking-at regexp) | |
702 | ;; If a saved dired buffer, look to which dir and | |
703 | ;; perhaps wildcard it belongs: | |
704 | (let ((dir (buffer-substring (match-beginning subexpr) | |
705 | (match-end subexpr)))) | |
706 | (file-name-as-directory dir))) | |
707 | ;; Else no match for headerline found. It's a raw ls listing. | |
708 | ;; In raw ls listings the directory does not have a headerline | |
709 | ;; try parent of first subdir, if any | |
710 | ((re-search-forward regexp nil t) | |
711 | (file-name-directory | |
712 | (directory-file-name | |
713 | (file-name-as-directory | |
714 | (buffer-substring (match-beginning subexpr) | |
715 | (match-end subexpr)))))) | |
716 | (t ; if all else fails | |
717 | nil)))) | |
718 | ||
719 | ||
720 | (defun dired-virtual-revert (&optional arg noconfirm) | |
721 | (if (not | |
722 | (y-or-n-p "Cannot revert a Virtual Dired buffer - switch to Real Dired mode? ")) | |
b847eb8c | 723 | (error "Cannot revert a Virtual Dired buffer") |
cb3fe1f0 RS |
724 | (setq mode-name "Dired" |
725 | revert-buffer-function 'dired-revert) | |
726 | (revert-buffer))) | |
727 | ||
728 | ;; A zero-arg version of dired-virtual. | |
729 | ;; You need my modified version of set-auto-mode for the | |
730 | ;; `buffer-contents-mode-alist'. | |
731 | ;; Or you use infer-mode.el and infer-mode-alist, same syntax. | |
732 | (defun dired-virtual-mode () | |
6fbad7af | 733 | "Put current buffer into Virtual Dired mode (see `dired-virtual'). |
cb3fe1f0 RS |
734 | Useful on `buffer-contents-mode-alist' (which see) with the regexp |
735 | ||
736 | \"^ \\(/[^ /]+\\)/?+:$\" | |
737 | ||
6fbad7af | 738 | to put saved dired buffers automatically into Virtual Dired mode. |
cb3fe1f0 RS |
739 | |
740 | Also useful for `auto-mode-alist' (which see) like this: | |
741 | ||
e7070c01 | 742 | \(setq auto-mode-alist (cons '(\"[^/]\\.dired\\'\" . dired-virtual-mode) |
cb3fe1f0 RS |
743 | auto-mode-alist)\)" |
744 | (interactive) | |
745 | (dired-virtual (dired-virtual-guess-dir))) | |
746 | ||
747 | \f | |
b578f267 | 748 | ;;; SMART SHELL. |
cb3fe1f0 RS |
749 | |
750 | ;;; An Emacs buffer can have but one working directory, stored in the | |
751 | ;;; buffer-local variable `default-directory'. A Dired buffer may have | |
752 | ;;; several subdirectories inserted, but still has but one working directory: | |
753 | ;;; that of the top level Dired directory in that buffer. For some commands | |
754 | ;;; it is appropriate that they use the current Dired directory instead of | |
755 | ;;; `default-directory', e.g., `find-file' and `compile'. This is a general | |
756 | ;;; mechanism is provided for special handling of the working directory in | |
757 | ;;; special major modes. | |
758 | ||
759 | ;; It's easier to add to this alist than redefine function | |
760 | ;; default-directory while keeping the old information. | |
761 | (defconst default-directory-alist | |
762 | '((dired-mode . (if (fboundp 'dired-current-directory) | |
763 | (dired-current-directory) | |
764 | default-directory))) | |
b847eb8c DL |
765 | "Alist of major modes and their opinion on `default-directory'. |
766 | This is given as a Lisp expression to evaluate. A resulting value of | |
767 | nil is ignored in favor of `default-directory'.") | |
cb3fe1f0 | 768 | |
b847eb8c DL |
769 | (defun dired-default-directory () |
770 | "Usage like variable `default-directory'. | |
771 | Knows about the special cases in variable `default-directory-alist'." | |
cb3fe1f0 RS |
772 | (or (eval (cdr (assq major-mode default-directory-alist))) |
773 | default-directory)) | |
774 | ||
775 | (defun dired-smart-shell-command (cmd &optional insert) | |
6fbad7af | 776 | "Like function `shell-command', but in the current Virtual Dired directory." |
93714f3c GM |
777 | (interactive (list (read-from-minibuffer "Shell command: " |
778 | nil nil nil 'shell-command-history) | |
779 | current-prefix-arg)) | |
b847eb8c | 780 | (let ((default-directory (dired-default-directory))) |
cb3fe1f0 RS |
781 | (shell-command cmd insert))) |
782 | ||
783 | \f | |
b578f267 | 784 | ;;; LOCAL VARIABLES FOR DIRED BUFFERS. |
cb3fe1f0 | 785 | |
9572a9dd KH |
786 | ;;; Brief Description: |
787 | ;;; | |
788 | ;;; * `dired-extra-startup' is part of the `dired-mode-hook'. | |
789 | ;;; | |
cb3fe1f0 | 790 | ;;; * `dired-extra-startup' calls `dired-hack-local-variables' |
9572a9dd | 791 | ;;; |
cb3fe1f0 | 792 | ;;; * `dired-hack-local-variables' checks the value of |
9572a9dd KH |
793 | ;;; `dired-local-variables-file' |
794 | ;;; | |
cb3fe1f0 RS |
795 | ;;; * Check if `dired-local-variables-file' is a non-nil string and is a |
796 | ;;; filename found in the directory of the Dired Buffer being created. | |
9572a9dd | 797 | ;;; |
cb3fe1f0 RS |
798 | ;;; * If `dired-local-variables-file' satisfies the above, then temporarily |
799 | ;;; include it in the Dired Buffer at the bottom. | |
9572a9dd | 800 | ;;; |
cb3fe1f0 RS |
801 | ;;; * Set `enable-local-variables' temporarily to the user variable |
802 | ;;; `dired-enable-local-variables' and run `hack-local-variables' on the | |
803 | ;;; Dired Buffer. | |
804 | ||
db8f8812 | 805 | (defvar dired-local-variables-file (convert-standard-filename ".dired") |
cb3fe1f0 RS |
806 | "Filename, as string, containing local dired buffer variables to be hacked. |
807 | If this file found in current directory, then it will be inserted into dired | |
6fbad7af JB |
808 | buffer and `hack-local-variables' will be run. See Info node |
809 | `(emacs)File Variables' for more information on local variables. | |
810 | See also `dired-enable-local-variables'.") | |
cb3fe1f0 RS |
811 | |
812 | (defun dired-hack-local-variables () | |
813 | "Evaluate local variables in `dired-local-variables-file' for dired buffer." | |
814 | (if (and dired-local-variables-file | |
815 | (stringp dired-local-variables-file) | |
816 | (file-exists-p dired-local-variables-file)) | |
817 | (let ((opoint (point-max)) | |
818 | buffer-read-only | |
819 | ;; In case user has `enable-local-variables' set to nil we | |
820 | ;; override it locally with dired's variable. | |
821 | (enable-local-variables dired-enable-local-variables)) | |
822 | ;; Insert 'em. | |
823 | (save-excursion | |
824 | (goto-char opoint) | |
825 | (insert "\^L\n") | |
826 | (insert-file-contents dired-local-variables-file)) | |
827 | ;; Hack 'em. | |
828 | (let ((buffer-file-name dired-local-variables-file)) | |
829 | (hack-local-variables)) | |
830 | ;; Make sure that the modeline shows the proper information. | |
831 | (dired-sort-set-modeline) | |
832 | ;; Delete this stuff: `eobp' is used to find last subdir by dired.el. | |
9572a9dd | 833 | (delete-region opoint (point-max))))) |
cb3fe1f0 | 834 | |
9572a9dd | 835 | (defun dired-omit-here-always () |
b847eb8c | 836 | "Create `dired-local-variables-file' for omitting and reverts directory. |
6fbad7af | 837 | Sets `dired-omit-mode' to t in a local variables file that is readable by |
cb3fe1f0 | 838 | dired." |
9572a9dd | 839 | (interactive) |
cb3fe1f0 RS |
840 | (if (file-exists-p dired-local-variables-file) |
841 | (message "File `./%s' already exists." dired-local-variables-file) | |
842 | ||
843 | ;; Create `dired-local-variables-file'. | |
844 | (save-excursion | |
845 | (set-buffer (get-buffer-create " *dot-dired*")) | |
846 | (erase-buffer) | |
ce64e046 | 847 | (insert "Local Variables:\ndired-omit-mode: t\nEnd:\n") |
cb3fe1f0 RS |
848 | (write-file dired-local-variables-file) |
849 | (kill-buffer (current-buffer))) | |
850 | ||
851 | ;; Run extra-hooks and revert directory. | |
852 | (dired-extra-startup) | |
853 | (dired-revert))) | |
854 | ||
855 | \f | |
b578f267 | 856 | ;;; GUESS SHELL COMMAND. |
cb3fe1f0 | 857 | |
9572a9dd KH |
858 | ;;; Brief Description: |
859 | ;;; | |
860 | ;;; `dired-do-shell-command' is bound to `!' by dired.el. | |
861 | ;;; | |
cb3fe1f0 RS |
862 | ;;; * Redefine `dired-do-shell-command' so it calls |
863 | ;;; `dired-guess-shell-command'. | |
9572a9dd | 864 | ;;; |
cb3fe1f0 RS |
865 | ;;; * `dired-guess-shell-command' calls `dired-guess-default' with list of |
866 | ;;; marked files. | |
9572a9dd | 867 | ;;; |
cb3fe1f0 RS |
868 | ;;; * Parse `dired-guess-shell-alist-user' and |
869 | ;;; `dired-guess-shell-alist-default' (in that order) for the first REGEXP | |
870 | ;;; that matches the first file in the file list. | |
9572a9dd | 871 | ;;; |
cb3fe1f0 | 872 | ;;; * If the REGEXP matches all the entries of the file list then evaluate |
c0d79871 | 873 | ;;; COMMAND, which is either a string or a Lisp expression returning a |
cb3fe1f0 | 874 | ;;; string. COMMAND may be a list of commands. |
9572a9dd | 875 | ;;; |
cb3fe1f0 | 876 | ;;; * Return this command to `dired-guess-shell-command' which prompts user |
34ff2275 | 877 | ;;; with it. The list of commands is temporarily put into the history list. |
cb3fe1f0 RS |
878 | ;;; If a command is used successfully then it is stored permanently in |
879 | ;;; `dired-shell-command-history'. | |
880 | ||
881 | ;;; Guess what shell command to apply to a file. | |
882 | (defvar dired-shell-command-history nil | |
883 | "History list for commands that read dired-shell commands.") | |
884 | ||
9572a9dd | 885 | ;;; Default list of shell commands. |
cb3fe1f0 RS |
886 | |
887 | ;;; NOTE: Use `gunzip -c' instead of `zcat' on `.gz' files. Some do not | |
888 | ;;; install GNU zip's version of zcat. | |
889 | ||
890 | (defvar dired-guess-shell-alist-default | |
891 | (list | |
ecd69427 JL |
892 | (list "\\.tar$" |
893 | '(if dired-guess-shell-gnutar | |
894 | (concat dired-guess-shell-gnutar " xvf") | |
895 | "tar xvf") | |
896 | ;; Extract files into a separate subdirectory | |
897 | '(if dired-guess-shell-gnutar | |
898 | (concat "mkdir " (file-name-sans-extension file) | |
899 | "; " dired-guess-shell-gnutar " -C " | |
900 | (file-name-sans-extension file) " -xvf") | |
901 | (concat "mkdir " (file-name-sans-extension file) | |
902 | "; tar -C " (file-name-sans-extension file) " -xvf"))) | |
cb3fe1f0 RS |
903 | |
904 | ;; REGEXPS for compressed archives must come before the .Z rule to | |
905 | ;; be recognized: | |
906 | (list "\\.tar\\.Z$" | |
907 | ;; Untar it. | |
908 | '(if dired-guess-shell-gnutar | |
909 | (concat dired-guess-shell-gnutar " zxvf") | |
910 | (concat "zcat * | tar xvf -")) | |
911 | ;; Optional conversion to gzip format. | |
912 | '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") | |
913 | " " dired-guess-shell-znew-switches)) | |
914 | ||
915 | ;; gzip'ed archives | |
2f017676 | 916 | (list "\\.t\\(ar\\.\\)?gz$" |
cb3fe1f0 RS |
917 | '(if dired-guess-shell-gnutar |
918 | (concat dired-guess-shell-gnutar " zxvf") | |
919 | (concat "gunzip -qc * | tar xvf -")) | |
ecd69427 JL |
920 | ;; Extract files into a separate subdirectory |
921 | '(if dired-guess-shell-gnutar | |
922 | (concat "mkdir " (file-name-sans-extension file) | |
923 | "; " dired-guess-shell-gnutar " -C " | |
924 | (file-name-sans-extension file) " -zxvf") | |
925 | (concat "mkdir " (file-name-sans-extension file) | |
926 | "; gunzip -qc * | tar -C " | |
927 | (file-name-sans-extension file) " -xvf -")) | |
cb3fe1f0 RS |
928 | ;; Optional decompression. |
929 | '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q" ""))) | |
ecd69427 | 930 | |
7ba7b794 | 931 | ;; bzip2'ed archives |
ecd69427 | 932 | (list "\\.t\\(ar\\.bz2\\|bz\\)$" |
7ba7b794 | 933 | "bunzip2 -c * | tar xvf -" |
ecd69427 JL |
934 | ;; Extract files into a separate subdirectory |
935 | '(concat "mkdir " (file-name-sans-extension file) | |
936 | "; bunzip2 -c * | tar -C " | |
937 | (file-name-sans-extension file) " -xvf -") | |
7ba7b794 KH |
938 | ;; Optional decompression. |
939 | "bunzip2") | |
cb3fe1f0 | 940 | |
ecd69427 JL |
941 | '("\\.shar\\.Z$" "zcat * | unshar") |
942 | '("\\.shar\\.g?z$" "gunzip -qc * | unshar") | |
cb3fe1f0 | 943 | |
85400f54 | 944 | '("\\.e?ps$" "ghostview" "xloadimage" "lpr") |
ecd69427 | 945 | (list "\\.e?ps\\.g?z$" "gunzip -qc * | ghostview -" |
cb3fe1f0 RS |
946 | ;; Optional decompression. |
947 | '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) | |
ecd69427 | 948 | (list "\\.e?ps\\.Z$" "zcat * | ghostview -" |
cb3fe1f0 RS |
949 | ;; Optional conversion to gzip format. |
950 | '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") | |
951 | " " dired-guess-shell-znew-switches)) | |
ecd69427 | 952 | |
cb3fe1f0 | 953 | '("\\.patch$" "cat * | patch") |
ecd69427 JL |
954 | (list "\\.patch\\.g?z$" "gunzip -qc * | patch" |
955 | ;; Optional decompression. | |
956 | '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) | |
957 | (list "\\.patch\\.Z$" "zcat * | patch" | |
cb3fe1f0 RS |
958 | ;; Optional conversion to gzip format. |
959 | '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") | |
960 | " " dired-guess-shell-znew-switches)) | |
961 | ||
ecd69427 JL |
962 | ;; The following four extensions are useful with dired-man ("N" key) |
963 | (list "\\.[0-9]$" '(progn (require 'man) | |
964 | (if (Man-support-local-filenames) | |
965 | "man -l" | |
966 | "cat * | tbl | nroff -man -h"))) | |
967 | (list "\\.[0-9]\\.g?z$" '(progn (require 'man) | |
968 | (if (Man-support-local-filenames) | |
969 | "man -l" | |
970 | "gunzip -qc * | tbl | nroff -man -h")) | |
971 | ;; Optional decompression. | |
972 | '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) | |
973 | (list "\\.[0-9]\\.Z$" '(progn (require 'man) | |
974 | (if (Man-support-local-filenames) | |
975 | "man -l" | |
976 | "zcat * | tbl | nroff -man -h")) | |
977 | ;; Optional conversion to gzip format. | |
978 | '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") | |
979 | " " dired-guess-shell-znew-switches)) | |
980 | '("\\.pod$" "perldoc" "pod2man * | nroff -man") | |
981 | ||
cb3fe1f0 | 982 | '("\\.dvi$" "xdvi" "dvips") ; preview and printing |
9572a9dd | 983 | '("\\.au$" "play") ; play Sun audiofiles |
cb3fe1f0 RS |
984 | '("\\.mpg$" "mpeg_play") |
985 | '("\\.uu$" "uudecode") ; for uudecoded files | |
986 | '("\\.hqx$" "mcvert") | |
987 | '("\\.sh$" "sh") ; execute shell scripts | |
988 | '("\\.xbm$" "bitmap") ; view X11 bitmaps | |
989 | '("\\.gp$" "gnuplot") | |
85400f54 RS |
990 | '("\\.p[bgpn]m$" "xloadimage") |
991 | '("\\.gif$" "xloadimage") ; view gif pictures | |
992 | '("\\.tif$" "xloadimage") | |
b847eb8c | 993 | '("\\.png$" "display") ; xloadimage 4.1 doesn't grok PNG |
ecd69427 | 994 | '("\\.jpe?g$" "xloadimage") |
cb3fe1f0 RS |
995 | '("\\.fig$" "xfig") ; edit fig pictures |
996 | '("\\.out$" "xgraph") ; for plotting purposes. | |
997 | '("\\.tex$" "latex" "tex") | |
998 | '("\\.texi\\(nfo\\)?$" "makeinfo" "texi2dvi") | |
ccdd9d57 | 999 | '("\\.pdf$" "xpdf") ; edit PDF files |
cb3fe1f0 RS |
1000 | |
1001 | ;; Some other popular archivers. | |
ecd69427 JL |
1002 | (list "\\.zip$" "unzip" |
1003 | ;; Extract files into a separate subdirectory | |
1004 | '(concat "unzip" (if dired-guess-shell-gzip-quiet " -q") | |
1005 | " -d " (file-name-sans-extension file))) | |
cb3fe1f0 | 1006 | '("\\.zoo$" "zoo x//") |
cb3fe1f0 RS |
1007 | '("\\.lzh$" "lharc x") |
1008 | '("\\.arc$" "arc x") | |
1009 | '("\\.shar$" "unshar") | |
1010 | ||
1011 | ;; Compression. | |
1012 | (list "\\.g?z$" '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) | |
ecd69427 | 1013 | (list "\\.dz$" "dictunzip") |
7ba7b794 | 1014 | (list "\\.bz2$" "bunzip2") |
cb3fe1f0 RS |
1015 | (list "\\.Z$" "uncompress" |
1016 | ;; Optional conversion to gzip format. | |
1017 | '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") | |
1018 | " " dired-guess-shell-znew-switches)) | |
1019 | ) | |
9572a9dd | 1020 | |
cb3fe1f0 | 1021 | "Default alist used for shell command guessing. |
b847eb8c | 1022 | See `dired-guess-shell-alist-user'.") |
cb3fe1f0 | 1023 | |
b847eb8c DL |
1024 | (defcustom dired-guess-shell-alist-user nil |
1025 | "User-defined alist of rules for suggested commands. | |
1026 | These rules take precedence over the predefined rules in the variable | |
cb3fe1f0 RS |
1027 | `dired-guess-shell-alist-default' (to which they are prepended). |
1028 | ||
1029 | Each element of this list looks like | |
1030 | ||
1031 | \(REGEXP COMMAND...\) | |
1032 | ||
6fbad7af | 1033 | where each COMMAND can either be a string or a Lisp expression that evaluates |
cb3fe1f0 RS |
1034 | to a string. If several COMMANDs are given, the first one will be the default |
1035 | and the rest will be added temporarily to the history and can be retrieved | |
1036 | with \\[previous-history-element] (M-p) . | |
1037 | ||
1038 | You can set this variable in your ~/.emacs. For example, to add rules for | |
1039 | `.foo' and `.bar' files, write | |
1040 | ||
1041 | \(setq dired-guess-shell-alist-user | |
b847eb8c | 1042 | (list (list \"\\\\.foo\\\\'\" \"FOO-COMMAND\");; fixed rule |
cb3fe1f0 | 1043 | ;; possibly more rules ... |
b847eb8c | 1044 | (list \"\\\\.bar\\\'\";; rule with condition test |
cb3fe1f0 RS |
1045 | '(if condition |
1046 | \"BAR-COMMAND-1\" | |
b847eb8c DL |
1047 | \"BAR-COMMAND-2\")))\)" |
1048 | :group 'dired-x | |
1049 | :type '(alist :key-type regexp :value-type (repeat sexp))) | |
cb3fe1f0 | 1050 | |
ecd69427 JL |
1051 | (defcustom dired-guess-shell-case-fold-search t |
1052 | "If non-nil, `dired-guess-shell-alist-default' and | |
1053 | `dired-guess-shell-alist-user' are matched case-insensitively." | |
1054 | :group 'dired-x | |
1055 | :type 'boolean) | |
82f648d3 | 1056 | |
cb3fe1f0 | 1057 | (defun dired-guess-default (files) |
b847eb8c DL |
1058 | "Guess a shell commands for FILES. Return command or list of commands. |
1059 | See `dired-guess-shell-alist-user'." | |
cb3fe1f0 | 1060 | |
82f648d3 | 1061 | (let* ((case-fold-search dired-guess-shell-case-fold-search) |
cb3fe1f0 RS |
1062 | ;; Prepend the user's alist to the default alist. |
1063 | (alist (append dired-guess-shell-alist-user | |
1064 | dired-guess-shell-alist-default)) | |
1065 | (file (car files)) | |
1066 | (flist (cdr files)) | |
1067 | elt regexp cmds) | |
1068 | ||
1069 | ;; Find the first match in the alist for first file in FILES. | |
1070 | (while alist | |
1071 | (setq elt (car alist) | |
1072 | regexp (car elt) | |
1073 | alist (cdr alist)) | |
1074 | (if (string-match regexp file) | |
1075 | (setq cmds (cdr elt) | |
1076 | alist nil))) | |
1077 | ||
1078 | ;; If more than one file, see if all of FILES match regular expression. | |
1079 | (while (and flist | |
1080 | (string-match regexp (car flist))) | |
1081 | (setq flist (cdr flist))) | |
9572a9dd | 1082 | |
cb3fe1f0 RS |
1083 | ;; If flist is still non-nil, then do not guess since this means that not |
1084 | ;; all the files in FILES were matched by the regexp. | |
1085 | (setq cmds (and (not flist) cmds)) | |
1086 | ||
9572a9dd KH |
1087 | ;; Return commands or nil if flist is still non-nil. |
1088 | ;; Evaluate the commands in order that any logical testing will be done. | |
cb3fe1f0 RS |
1089 | (cond ((not (cdr cmds)) |
1090 | (eval (car cmds))) ; single command | |
1091 | (t | |
1092 | (mapcar (function eval) cmds))))) | |
1093 | ||
1094 | (defun dired-guess-shell-command (prompt files) | |
b847eb8c | 1095 | "Ask user with PROMPT for a shell command, guessing a default from FILES." |
cb3fe1f0 RS |
1096 | |
1097 | (let ((default (dired-guess-default files)) | |
1098 | default-list old-history val (failed t)) | |
1099 | ||
1100 | (if (null default) | |
1101 | ;; Nothing to guess | |
1102 | (read-from-minibuffer prompt nil nil nil 'dired-shell-command-history) | |
1103 | ||
1104 | ;; Save current history list | |
1105 | (setq old-history dired-shell-command-history) | |
1106 | ||
1107 | (if (listp default) | |
1108 | ||
1109 | ;; More than one guess | |
1110 | (setq default-list default | |
1111 | default (car default) | |
1112 | prompt (concat | |
1113 | prompt | |
1114 | (format "{%d guesses} " (length default-list)))) | |
1115 | ||
1116 | ;; Just one guess | |
1117 | (setq default-list (list default))) | |
1118 | ||
1119 | ;; Push all guesses onto history so that they can be retrieved with M-p | |
1120 | ;; and put the first guess in the prompt but not in the initial value. | |
1121 | (setq dired-shell-command-history | |
1122 | (append default-list dired-shell-command-history) | |
1123 | prompt (concat prompt (format "[%s] " default))) | |
1124 | ||
1125 | ;; The unwind-protect returns VAL, and we too. | |
1126 | (unwind-protect | |
1127 | ;; BODYFORM | |
1128 | (progn | |
1129 | (setq val (read-from-minibuffer prompt nil nil nil | |
1130 | 'dired-shell-command-history) | |
1131 | failed nil) | |
1132 | ;; If we got a return, then use default. | |
1133 | (if (equal val "") | |
1134 | (setq val default)) | |
1135 | val) | |
1136 | ||
1137 | ;; UNWINDFORMS | |
1138 | ;; Undo pushing onto the history list so that an aborted | |
1139 | ;; command doesn't get the default in the next command. | |
1140 | (setq dired-shell-command-history old-history) | |
1141 | (if (not failed) | |
1142 | (or (equal val (car-safe dired-shell-command-history)) | |
1143 | (setq dired-shell-command-history | |
1144 | (cons val dired-shell-command-history)))))))) | |
1145 | ||
1146 | ||
9572a9dd | 1147 | ;;; REDEFINE. |
cb3fe1f0 RS |
1148 | ;;; Redefine dired-aux.el's version: |
1149 | (defun dired-read-shell-command (prompt arg files) | |
b847eb8c DL |
1150 | "Read a dired shell command prompting with PROMPT (using read-string). |
1151 | ARG is the prefix arg and may be used to indicate in the prompt which | |
1152 | files are affected. | |
1153 | This is an extra function so that you can redefine it." | |
cb3fe1f0 RS |
1154 | (dired-mark-pop-up |
1155 | nil 'shell files | |
1156 | 'dired-guess-shell-command | |
1157 | (format prompt (dired-mark-prompt arg files)) ; PROMPT | |
1158 | files)) ; FILES | |
1159 | ||
1160 | \f | |
b578f267 | 1161 | ;;; RELATIVE SYMBOLIC LINKS. |
cb3fe1f0 RS |
1162 | |
1163 | (defvar dired-keep-marker-relsymlink ?S | |
1164 | "See variable `dired-keep-marker-move'.") | |
1165 | ||
1166 | (defun dired-make-relative-symlink (file1 file2 &optional ok-if-already-exists) | |
b847eb8c | 1167 | "Make a symbolic link (pointing to FILE1) in FILE2. |
cb3fe1f0 RS |
1168 | The link is relative (if possible), for example |
1169 | ||
1170 | \"/vol/tex/bin/foo\" \"/vol/local/bin/foo\" | |
1171 | ||
1172 | results in | |
1173 | ||
b847eb8c | 1174 | \"../../tex/bin/foo\" \"/vol/local/bin/foo\"" |
cb3fe1f0 RS |
1175 | (interactive "FRelSymLink: \nFRelSymLink %s: \np") |
1176 | (let (name1 name2 len1 len2 (index 0) sub) | |
1177 | (setq file1 (expand-file-name file1) | |
1178 | file2 (expand-file-name file2) | |
1179 | len1 (length file1) | |
1180 | len2 (length file2)) | |
470fa6d1 | 1181 | ;; Find common initial file name components: |
cb3fe1f0 RS |
1182 | (let (next) |
1183 | (while (and (setq next (string-match "/" file1 index)) | |
1184 | (setq next (1+ next)) | |
1185 | (< next (min len1 len2)) | |
1186 | ;; For the comparison, both substrings must end in | |
1187 | ;; `/', so NEXT is *one plus* the result of the | |
1188 | ;; string-match. | |
1189 | ;; E.g., consider the case of linking "/tmp/a/abc" | |
34ff2275 | 1190 | ;; to "/tmp/abc" erroneously giving "/tmp/a" instead |
cb3fe1f0 RS |
1191 | ;; of "/tmp/" as common initial component |
1192 | (string-equal (substring file1 0 next) | |
1193 | (substring file2 0 next))) | |
1194 | (setq index next)) | |
1195 | (setq name2 file2 | |
1196 | sub (substring file1 0 index) | |
1197 | name1 (substring file1 index))) | |
1198 | (if (string-equal sub "/") | |
470fa6d1 | 1199 | ;; No common initial file name found |
cb3fe1f0 RS |
1200 | (setq name1 file1) |
1201 | ;; Else they have a common parent directory | |
1202 | (let ((tem (substring file2 index)) | |
1203 | (start 0) | |
1204 | (count 0)) | |
1205 | ;; Count number of slashes we must compensate for ... | |
1206 | (while (setq start (string-match "/" tem start)) | |
1207 | (setq count (1+ count) | |
1208 | start (1+ start))) | |
1209 | ;; ... and prepend a "../" for each slash found: | |
1210 | (while (> count 0) | |
1211 | (setq count (1- count) | |
1212 | name1 (concat "../" name1))))) | |
1213 | (make-symbolic-link | |
1214 | (directory-file-name name1) ; must not link to foo/ | |
1215 | ; (trailing slash!) | |
1216 | name2 ok-if-already-exists))) | |
1217 | ||
1218 | (defun dired-do-relsymlink (&optional arg) | |
b847eb8c DL |
1219 | "Relative symlink all marked (or next ARG) files into a directory. |
1220 | Otherwise make a relative symbolic link to the current file. | |
cb3fe1f0 RS |
1221 | This creates relative symbolic links like |
1222 | ||
1223 | foo -> ../bar/foo | |
1224 | ||
1225 | not absolute ones like | |
1226 | ||
470fa6d1 | 1227 | foo -> /ugly/file/name/that/may/change/any/day/bar/foo" |
cb3fe1f0 RS |
1228 | (interactive "P") |
1229 | (dired-do-create-files 'relsymlink (function dired-make-relative-symlink) | |
1230 | "RelSymLink" arg dired-keep-marker-relsymlink)) | |
1231 | ||
d8e396ce | 1232 | (defun dired-do-relsymlink-regexp (regexp newname &optional arg whole-name) |
cb3fe1f0 RS |
1233 | "RelSymlink all marked files containing REGEXP to NEWNAME. |
1234 | See functions `dired-do-rename-regexp' and `dired-do-relsymlink' | |
1235 | for more info." | |
1236 | (interactive (dired-mark-read-regexp "RelSymLink")) | |
1237 | (dired-do-create-files-regexp | |
1238 | (function dired-make-relative-symlink) | |
d8e396ce | 1239 | "RelSymLink" arg regexp newname whole-name dired-keep-marker-relsymlink)) |
cb3fe1f0 RS |
1240 | |
1241 | \f | |
b578f267 | 1242 | ;;; VISIT ALL MARKED FILES SIMULTANEOUSLY. |
cb3fe1f0 | 1243 | |
9572a9dd KH |
1244 | ;;; Brief Description: |
1245 | ;;; | |
1246 | ;;; `dired-do-find-marked-files' is bound to `F' by dired-x.el. | |
1247 | ;;; | |
cb3fe1f0 | 1248 | ;;; * Use `dired-get-marked-files' to collect the marked files in the current |
9572a9dd KH |
1249 | ;;; Dired Buffer into a list of filenames `FILE-LIST'. |
1250 | ;;; | |
cb3fe1f0 RS |
1251 | ;;; * Pass FILE-LIST to `dired-simultaneous-find-file' all with |
1252 | ;;; `dired-do-find-marked-files''s prefix argument NOSELECT. | |
9572a9dd | 1253 | ;;; |
cb3fe1f0 RS |
1254 | ;;; * `dired-simultaneous-find-file' runs through FILE-LIST decrementing the |
1255 | ;;; list each time. | |
9572a9dd | 1256 | ;;; |
cb3fe1f0 RS |
1257 | ;;; * If NOSELECT is non-nil then just run `find-file-noselect' on each |
1258 | ;;; element of FILE-LIST. | |
9572a9dd | 1259 | ;;; |
cb3fe1f0 RS |
1260 | ;;; * If NOSELECT is nil then calculate the `size' of the window for each file |
1261 | ;;; by dividing the `window-height' by length of FILE-LIST. Thus, `size' is | |
1262 | ;;; cognizant of the window-configuration. | |
9572a9dd | 1263 | ;;; |
cb3fe1f0 RS |
1264 | ;;; * If `size' is too small abort, otherwise run `find-file' on each element |
1265 | ;;; of FILE-LIST giving each a window of height `size'. | |
1266 | ||
1267 | (defun dired-do-find-marked-files (&optional noselect) | |
1268 | "Find all marked files displaying all of them simultaneously. | |
1269 | With optional NOSELECT just find files but do not select them. | |
1270 | ||
1271 | The current window is split across all files marked, as evenly as possible. | |
1272 | Remaining lines go to bottom-most window. The number of files that can be | |
1273 | displayed this way is restricted by the height of the current window and | |
1274 | `window-min-height'. | |
1275 | ||
9572a9dd | 1276 | To keep dired buffer displayed, type \\[split-window-vertically] first. |
cb3fe1f0 RS |
1277 | To display just marked files, type \\[delete-other-windows] first." |
1278 | ||
1279 | (interactive "P") | |
1280 | (dired-simultaneous-find-file (dired-get-marked-files) noselect)) | |
1281 | ||
1282 | (defun dired-simultaneous-find-file (file-list noselect) | |
1283 | ||
b847eb8c DL |
1284 | "Visit all files in FILE-LIST and display them simultaneously. |
1285 | The current window is split across all files in FILE-LIST, as evenly as | |
1286 | possible. Remaining lines go to the bottom-most window. The number of | |
1287 | files that can be displayed this way is restricted by the height of the | |
1288 | current window and the variable `window-min-height'. With non-nil | |
1289 | NOSELECT the files are merely found but not selected." | |
9572a9dd | 1290 | |
cb3fe1f0 RS |
1291 | ;; We don't make this function interactive because it is usually too clumsy |
1292 | ;; to specify FILE-LIST interactively unless via dired. | |
1293 | ||
1294 | (let (size) | |
1295 | ||
1296 | (if noselect | |
1297 | ;; Do not select the buffer. | |
1298 | (find-file-noselect (car file-list)) | |
1299 | ||
1300 | ;; We will have to select the buffer. Calculate and check window size. | |
1301 | (setq size (/ (window-height) (length file-list))) | |
1302 | (or (<= window-min-height size) | |
b847eb8c | 1303 | (error "Too many files to visit simultaneously. Try C-u prefix")) |
cb3fe1f0 RS |
1304 | (find-file (car file-list))) |
1305 | ||
1306 | ;; Decrement. | |
1307 | (setq file-list (cdr file-list)) | |
1308 | ||
1309 | (while file-list | |
1310 | ||
1311 | (if noselect | |
1312 | ;; Do not select the buffer. | |
1313 | (find-file-noselect (car file-list)) | |
1314 | ||
1315 | ;; Vertically split off a window of desired size. Upper window will | |
1316 | ;; have SIZE lines. Select lower (larger) window. We split it again. | |
1317 | (select-window (split-window nil size)) | |
1318 | (find-file (car file-list))) | |
1319 | ||
1320 | ;; Decrement. | |
1321 | (setq file-list (cdr file-list))))) | |
1322 | ||
1323 | \f | |
b578f267 | 1324 | ;;; MISCELLANEOUS COMMANDS. |
cb3fe1f0 | 1325 | |
9572a9dd KH |
1326 | ;;; Run man on files. |
1327 | ||
cb3fe1f0 | 1328 | (defun dired-man () |
9572a9dd | 1329 | "Run man on this file. Display old buffer if buffer name matches filename. |
6fbad7af | 1330 | Uses `man.el' of \\[manual-entry] fame." |
cb3fe1f0 | 1331 | (interactive) |
685ff9f8 | 1332 | (require 'man) |
ecd69427 JL |
1333 | (let* ((file (dired-get-filename)) |
1334 | (manual-program (replace-regexp-in-string "\\*" "%s" | |
1335 | (dired-guess-shell-command | |
1336 | "Man command: " (list file))))) | |
685ff9f8 | 1337 | (Man-getpage-in-background file))) |
cb3fe1f0 RS |
1338 | |
1339 | ;;; Run Info on files. | |
1340 | ||
1341 | (defun dired-info () | |
1342 | "Run info on this file." | |
1343 | (interactive) | |
1344 | (info (dired-get-filename))) | |
1345 | ||
1346 | ;;; Run mail on mail folders. | |
1347 | ||
9572a9dd KH |
1348 | ;;; (and (not (fboundp 'vm-visit-folder)) |
1349 | ;;; (defun vm-visit-folder (file &optional arg) | |
1350 | ;;; nil)) | |
1351 | ||
cb3fe1f0 RS |
1352 | (defun dired-vm (&optional read-only) |
1353 | "Run VM on this file. | |
1354 | With prefix arg, visit folder read-only (this requires at least VM 5). | |
1355 | See also variable `dired-vm-read-only-folders'." | |
1356 | (interactive "P") | |
1357 | (let ((dir (dired-current-directory)) | |
1358 | (fil (dired-get-filename))) | |
1359 | ;; take care to supply 2nd arg only if requested - may still run VM 4! | |
1360 | (cond (read-only (vm-visit-folder fil t)) | |
1361 | ((eq t dired-vm-read-only-folders) (vm-visit-folder fil t)) | |
1362 | ((null dired-vm-read-only-folders) (vm-visit-folder fil)) | |
1363 | (t (vm-visit-folder fil (not (file-writable-p fil))))) | |
1364 | ;; so that pressing `v' inside VM does prompt within current directory: | |
1365 | (set (make-local-variable 'vm-folder-directory) dir))) | |
1366 | ||
1367 | (defun dired-rmail () | |
1368 | "Run RMAIL on this file." | |
1369 | (interactive) | |
1370 | (rmail (dired-get-filename))) | |
1371 | ||
1372 | (defun dired-do-run-mail () | |
1373 | "If `dired-bind-vm' is t, then function `dired-vm', otherwise `dired-rmail'." | |
1374 | (interactive) | |
1375 | (if dired-bind-vm | |
1376 | ;; Read mail folder using vm. | |
1377 | (dired-vm) | |
1378 | ;; Read mail folder using rmail. | |
1379 | (dired-rmail))) | |
1380 | ||
1381 | \f | |
b578f267 | 1382 | ;;; MISCELLANEOUS INTERNAL FUNCTIONS. |
cb3fe1f0 RS |
1383 | |
1384 | (or (fboundp 'dired-old-find-buffer-nocreate) | |
1385 | (fset 'dired-old-find-buffer-nocreate | |
1386 | (symbol-function 'dired-find-buffer-nocreate))) | |
1387 | ||
9572a9dd | 1388 | ;;; REDEFINE. |
cb3fe1f0 | 1389 | ;;; Redefines dired.el's version of `dired-find-buffer-nocreate' |
ac1ce341 | 1390 | (defun dired-find-buffer-nocreate (dirname &optional mode) |
10774fb5 KH |
1391 | (if (and dired-find-subdir |
1392 | ;; don't try to find a wildcard as a subdirectory | |
1393 | (string-equal dirname (file-name-directory dirname))) | |
cb3fe1f0 | 1394 | (let* ((cur-buf (current-buffer)) |
10774fb5 | 1395 | (buffers (nreverse |
12c38283 | 1396 | (dired-buffers-for-dir (expand-file-name dirname)))) |
10774fb5 KH |
1397 | (cur-buf-matches (and (memq cur-buf buffers) |
1398 | ;; wildcards must match, too: | |
1399 | (equal dired-directory dirname)))) | |
1400 | ;; We don't want to switch to the same buffer--- | |
1401 | (setq buffers (delq cur-buf buffers));;need setq with delq | |
1402 | (or (car (sort buffers (function dired-buffer-more-recently-used-p))) | |
1403 | ;; ---unless it's the only possibility: | |
1404 | (and cur-buf-matches cur-buf))) | |
ac1ce341 | 1405 | (dired-old-find-buffer-nocreate dirname mode))) |
cb3fe1f0 RS |
1406 | |
1407 | ;; This should be a builtin | |
1408 | (defun dired-buffer-more-recently-used-p (buffer1 buffer2) | |
1409 | "Return t if BUFFER1 is more recently used than BUFFER2." | |
1410 | (if (equal buffer1 buffer2) | |
1411 | nil | |
1412 | (let ((more-recent nil) | |
1413 | (list (buffer-list))) | |
1414 | (while (and list | |
1415 | (not (setq more-recent (equal buffer1 (car list)))) | |
1416 | (not (equal buffer2 (car list)))) | |
1417 | (setq list (cdr list))) | |
1418 | more-recent))) | |
1419 | ||
1420 | ;;; Same thing as `dired-buffers-for-dir' of dired.el? - lrd 11/23/93 | |
1421 | ;;; (defun dired-buffers-for-dir-exact (dir) | |
1422 | ;;; ;; Return a list of buffers that dired DIR (a directory or wildcard) | |
1423 | ;;; ;; at top level, or as subdirectory. | |
1424 | ;;; ;; Top level matches must match the wildcard part too, if any. | |
1425 | ;;; ;; The list is in reverse order of buffer creation, most recent last. | |
1426 | ;;; ;; As a side effect, killed dired buffers for DIR are removed from | |
1427 | ;;; ;; dired-buffers. | |
1428 | ;;; (let ((alist dired-buffers) result elt) | |
1429 | ;;; (while alist | |
1430 | ;;; (setq elt (car alist) | |
1431 | ;;; alist (cdr alist)) | |
1432 | ;;; (let ((buf (cdr elt))) | |
1433 | ;;; (if (buffer-name buf) | |
1434 | ;;; ;; Top level must match exactly against dired-directory in | |
1435 | ;;; ;; case one of them is a wildcard. | |
1436 | ;;; (if (or (equal dir (save-excursion (set-buffer buf) | |
1437 | ;;; dired-directory)) | |
1438 | ;;; (assoc dir (save-excursion (set-buffer buf) | |
1439 | ;;; dired-subdir-alist))) | |
1440 | ;;; (setq result (cons buf result))) | |
1441 | ;;; ;; else buffer is killed - clean up: | |
1442 | ;;; (setq dired-buffers (delq elt dired-buffers))))) | |
1443 | ;;; result)) | |
1444 | ||
9572a9dd | 1445 | ;;; REDEFINE. |
cb3fe1f0 RS |
1446 | ;;; Redefines dired.el's version of `dired-initial-position' |
1447 | (defun dired-initial-position (dirname) | |
b847eb8c DL |
1448 | "Where point should go in a new listing of DIRNAME. |
1449 | Point assumed at beginning of new subdir line. | |
6fbad7af | 1450 | You may redefine this function as you wish, e.g. like in `dired-x.el'." |
cb3fe1f0 RS |
1451 | (end-of-line) |
1452 | (if dired-find-subdir (dired-goto-subdir dirname)) ; new | |
1453 | (if dired-trivial-filenames (dired-goto-next-nontrivial-file))) | |
1454 | ||
1455 | \f | |
1456 | ;; Does anyone use this? - lrd 6/29/93. | |
44c816da | 1457 | ;; Apparently people do use it. - lrd 12/22/97. |
cb3fe1f0 RS |
1458 | (defun dired-mark-sexp (predicate &optional unflag-p) |
1459 | "Mark files for which PREDICATE returns non-nil. | |
1460 | With a prefix arg, unflag those files instead. | |
1461 | ||
1462 | PREDICATE is a lisp expression that can refer to the following symbols: | |
1463 | ||
1464 | inode [integer] the inode of the file (only for ls -i output) | |
1465 | s [integer] the size of the file for ls -s output | |
34ff2275 | 1466 | (usually in blocks or, with -k, in KByte) |
cb3fe1f0 RS |
1467 | mode [string] file permission bits, e.g. \"-rw-r--r--\" |
1468 | nlink [integer] number of links to file | |
1469 | uid [string] owner | |
1470 | gid [string] group (If the gid is not displayed by ls, | |
1471 | this will still be set (to the same as uid)) | |
1472 | size [integer] file size in bytes | |
1473 | time [string] the time that ls displays, e.g. \"Feb 12 14:17\" | |
1474 | name [string] the name of the file | |
1475 | sym [string] if file is a symbolic link, the linked-to name, else \"\" | |
1476 | ||
1477 | For example, use | |
1478 | ||
1479 | (equal 0 size) | |
1480 | ||
1481 | to mark all zero length files." | |
1482 | ;; Using sym="" instead of nil avoids the trap of | |
1483 | ;; (string-match "foo" sym) into which a user would soon fall. | |
1484 | ;; Give `equal' instead of `=' in the example, as this works on | |
1485 | ;; integers and strings. | |
1486 | (interactive "xMark if (lisp expr): \nP") | |
1487 | (message "%s" predicate) | |
1488 | (let ((dired-marker-char (if unflag-p ?\040 dired-marker-char)) | |
1489 | inode s mode nlink uid gid size time name sym) | |
1490 | (dired-mark-if | |
1491 | (save-excursion | |
1492 | (and | |
1493 | ;; Sets vars | |
1494 | ;; inode s mode nlink uid gid size time name sym | |
1495 | ||
1496 | ;; according to current file line. Returns t for success, nil if | |
1497 | ;; there is no file line. Upon success, all variables are set, either | |
1498 | ;; to nil or the appropriate value, so they need not be initialized. | |
1499 | ;; Moves point within the current line. | |
1500 | (if (dired-move-to-filename) | |
1501 | (let (pos | |
1502 | (mode-len 10) ; length of mode string | |
1503 | ;; like in dired.el, but with subexpressions \1=inode, \2=s: | |
1504 | (dired-re-inode-size "\\s *\\([0-9]*\\)\\s *\\([0-9]*\\) ?")) | |
1505 | (beginning-of-line) | |
1506 | (forward-char 2) | |
1507 | (if (looking-at dired-re-inode-size) | |
1508 | (progn | |
1509 | (goto-char (match-end 0)) | |
027a4b6b JB |
1510 | (setq inode (string-to-number (buffer-substring (match-beginning 1) |
1511 | (match-end 1))) | |
1512 | s (string-to-number (buffer-substring (match-beginning 2) | |
1513 | (match-end 2))))) | |
cb3fe1f0 RS |
1514 | (setq inode nil |
1515 | s nil)) | |
1516 | (setq mode (buffer-substring (point) (+ mode-len (point)))) | |
1517 | (forward-char mode-len) | |
1518 | (setq nlink (read (current-buffer))) | |
44c816da | 1519 | ;; Karsten Wenger <kw@cis.uni-muenchen.de> fixed uid. |
b847eb8c DL |
1520 | (setq uid (buffer-substring (+ (point) 1) |
1521 | (progn (forward-word 1) (point)))) | |
9bc260cf | 1522 | (re-search-forward directory-listing-before-filename-regexp) |
cb3fe1f0 RS |
1523 | (goto-char (match-beginning 1)) |
1524 | (forward-char -1) | |
027a4b6b JB |
1525 | (setq size (string-to-number (buffer-substring (save-excursion |
1526 | (backward-word 1) | |
1527 | (setq pos (point))) | |
1528 | (point)))) | |
cb3fe1f0 RS |
1529 | (goto-char pos) |
1530 | (backward-word 1) | |
1531 | ;; if no gid is displayed, gid will be set to uid | |
1532 | ;; but user will then not reference it anyway in PREDICATE. | |
b847eb8c DL |
1533 | (setq gid (buffer-substring (save-excursion |
1534 | (forward-word 1) (point)) | |
cb3fe1f0 RS |
1535 | (point)) |
1536 | time (buffer-substring (match-beginning 1) | |
1537 | (1- (dired-move-to-filename))) | |
1538 | name (buffer-substring (point) | |
b847eb8c DL |
1539 | (or |
1540 | (dired-move-to-end-of-filename t) | |
1541 | (point))) | |
cb3fe1f0 RS |
1542 | sym (progn |
1543 | (if (looking-at " -> ") | |
b847eb8c DL |
1544 | (buffer-substring |
1545 | (progn (forward-char 4) (point)) | |
1546 | (progn (end-of-line) (point))) | |
cb3fe1f0 RS |
1547 | ""))) |
1548 | t) | |
1549 | nil) | |
1550 | (eval predicate))) | |
1551 | (format "'%s file" predicate)))) | |
1552 | ||
1553 | \f | |
b578f267 | 1554 | ;;; FIND FILE AT POINT. |
cb3fe1f0 | 1555 | |
ccb1d39a | 1556 | (defvar dired-x-hands-off-my-keys t |
b847eb8c | 1557 | "*Non-nil means don't bind `dired-x-find-file' over `find-file' on keyboard. |
ccb1d39a | 1558 | Similarly for `dired-x-find-file-other-window' over `find-file-other-window'. |
6fbad7af | 1559 | If you change this variable after `dired-x.el' is loaded then do |
ccb1d39a RS |
1560 | \\[dired-x-bind-find-file].") |
1561 | ||
1562 | ;;; Bind `dired-x-find-file{-other-window}' over wherever | |
1563 | ;;; `find-file{-other-window}' is bound? | |
1564 | (defun dired-x-bind-find-file () | |
1565 | "Bind `dired-x-find-file' in place of `find-file' \(or reverse\). | |
1566 | Similarly for `dired-x-find-file-other-window' and `find-file-other-window'. | |
1567 | Binding direction based on `dired-x-hands-off-my-keys'. | |
6fbad7af | 1568 | This function is part of `after-init-hook'." |
ccb1d39a RS |
1569 | (interactive) |
1570 | (if (interactive-p) | |
1571 | (setq dired-x-hands-off-my-keys | |
1572 | (not (y-or-n-p "Bind dired-x-find-file over find-file? ")))) | |
1573 | (cond ((not dired-x-hands-off-my-keys) | |
1574 | (substitute-key-definition 'find-file | |
1575 | 'dired-x-find-file | |
1576 | (current-global-map)) | |
1577 | (substitute-key-definition 'find-file-other-window | |
1578 | 'dired-x-find-file-other-window | |
1579 | (current-global-map))) | |
1580 | (t | |
1581 | (substitute-key-definition 'dired-x-find-file | |
1582 | 'find-file | |
1583 | (current-global-map)) | |
1584 | (substitute-key-definition 'dired-x-find-file-other-window | |
1585 | 'find-file-other-window | |
1586 | (current-global-map)))) | |
1587 | ;; Clear mini-buffer. | |
1588 | (message nil)) | |
1589 | ||
1590 | ;;; Now call it so binding is correct and put on `after-init-hook' in case | |
1591 | ;;; user changes binding. | |
1592 | (dired-x-bind-find-file) | |
1593 | (add-hook 'after-init-hook 'dired-x-bind-find-file) | |
1594 | ||
1595 | (defun dired-x-find-file (filename) | |
1596 | "Edit file FILENAME. | |
1597 | May create a new window, or reuse an existing one. | |
1598 | See the function `display-buffer'. | |
1599 | ||
1600 | Identical to `find-file' except when called interactively, with a prefix arg | |
6fbad7af JB |
1601 | \(e.g., \\[universal-argument]\), in which case it guesses filename near point. |
1602 | Useful for editing file mentioned in buffer you are viewing, | |
1603 | or to test if that file exists. Use minibuffer after snatching filename." | |
ccb1d39a RS |
1604 | (interactive (list (read-filename-at-point "Find file: "))) |
1605 | (find-file (expand-file-name filename))) | |
1606 | ||
1607 | (defun dired-x-find-file-other-window (filename) | |
1608 | "Edit file FILENAME, in another window. | |
1609 | May create a new window, or reuse an existing one. | |
1610 | See the function `display-buffer'. | |
1611 | ||
1612 | Identical to `find-file-other-window' except when called interactively, with a | |
6fbad7af JB |
1613 | prefix arg \(e.g., \\[universal-argument]\), in which case it guesses filename near point. |
1614 | Useful for editing file mentioned in buffer you are viewing, | |
1615 | or to test if that file exists. Use minibuffer after snatching filename." | |
ccb1d39a RS |
1616 | (interactive (list (read-filename-at-point "Find file: "))) |
1617 | (find-file-other-window (expand-file-name filename))) | |
1618 | ||
1619 | ;;; Internal functions. | |
cb3fe1f0 | 1620 | |
1e56daa5 | 1621 | ;; Fixme: This should probably use `thing-at-point'. -- fx |
f53a06c3 | 1622 | (defun dired-filename-at-point () |
b847eb8c DL |
1623 | "Get the filename closest to point, but do not change position. |
1624 | Has a preference for looking backward when not directly on a symbol. Not | |
1625 | perfect - point must be in middle of or end of filename." | |
cb3fe1f0 | 1626 | |
f53a06c3 | 1627 | (let ((filename-chars "-.[:alnum:]_/:$+@") |
6b622862 | 1628 | start end filename prefix) |
cb3fe1f0 RS |
1629 | |
1630 | (save-excursion | |
1631 | ;; First see if just past a filename. | |
1632 | (if (not (eobp)) | |
1633 | (if (looking-at "[] \t\n[{}()]") ; whitespace or some parens | |
1634 | (progn | |
1635 | (skip-chars-backward " \n\t\r({[]})") | |
1636 | (if (not (bobp)) | |
1637 | (backward-char 1))))) | |
9572a9dd | 1638 | |
cb3fe1f0 RS |
1639 | (if (string-match (concat "[" filename-chars "]") |
1640 | (char-to-string (following-char))) | |
1641 | (progn | |
1e56daa5 DL |
1642 | (if (re-search-backward (concat "[^" filename-chars "]") nil t) |
1643 | (forward-char) | |
1644 | (goto-char (point-min))) | |
cb3fe1f0 | 1645 | (setq start (point)) |
6b622862 | 1646 | (setq prefix |
1e56daa5 DL |
1647 | (and (string-match |
1648 | "^\\w+@" | |
1649 | (buffer-substring start (line-beginning-position))) | |
6b622862 GM |
1650 | "/")) |
1651 | (goto-char start) | |
cb3fe1f0 RS |
1652 | (if (string-match "[/~]" (char-to-string (preceding-char))) |
1653 | (setq start (1- start))) | |
1e56daa5 | 1654 | (re-search-forward (concat "\\=[" filename-chars "]*") nil t)) |
cb3fe1f0 RS |
1655 | |
1656 | (error "No file found around point!")) | |
1657 | ||
9572a9dd | 1658 | ;; Return string. |
6b622862 | 1659 | (expand-file-name (concat prefix (buffer-substring start (point))))))) |
cb3fe1f0 | 1660 | |
ccb1d39a | 1661 | (defun read-filename-at-point (prompt) |
b847eb8c DL |
1662 | "Return filename prompting with PROMPT with completion. |
1663 | If `current-prefix-arg' is non-nil, uses name at point as guess." | |
ccb1d39a RS |
1664 | (if current-prefix-arg |
1665 | (let ((guess (dired-filename-at-point))) | |
1666 | (read-file-name prompt | |
1667 | (file-name-directory guess) | |
1668 | guess | |
1669 | nil (file-name-nondirectory guess))) | |
1670 | (read-file-name prompt default-directory))) | |
cb3fe1f0 | 1671 | \f |
b578f267 | 1672 | ;;; BUG REPORTS |
cb3fe1f0 | 1673 | |
b847eb8c DL |
1674 | ;; Fixme: get rid of this later. |
1675 | ||
cb3fe1f0 RS |
1676 | ;;; This section is provided for reports. It uses Barry A. Warsaw's |
1677 | ;;; reporter.el which is bundled with GNU Emacs v19. | |
1678 | ||
b847eb8c | 1679 | (defconst dired-x-help-address "bug-gnu-emacs@gnu.org" |
cb3fe1f0 RS |
1680 | "Address(es) accepting submission of reports on dired-x.el.") |
1681 | ||
cb3fe1f0 | 1682 | (defconst dired-x-variable-list |
9572a9dd | 1683 | (list |
cb3fe1f0 RS |
1684 | 'dired-bind-vm |
1685 | 'dired-vm-read-only-folders | |
1686 | 'dired-bind-jump | |
1687 | 'dired-bind-info | |
1688 | 'dired-bind-man | |
1689 | 'dired-find-subdir | |
1690 | 'dired-enable-local-variables | |
1691 | 'dired-local-variables-file | |
1692 | 'dired-guess-shell-gnutar | |
1693 | 'dired-guess-shell-gzip-quiet | |
1694 | 'dired-guess-shell-znew-switches | |
1695 | 'dired-guess-shell-alist-user | |
1696 | 'dired-clean-up-buffers-too | |
ce64e046 | 1697 | 'dired-omit-mode |
cb3fe1f0 RS |
1698 | 'dired-omit-files |
1699 | 'dired-omit-extensions | |
1700 | ) | |
b847eb8c | 1701 | "List of variables to be appended to reports sent by `dired-x-submit-report'.") |
cb3fe1f0 RS |
1702 | |
1703 | (defun dired-x-submit-report () | |
6fbad7af | 1704 | "Submit via `reporter.el' a bug report on program. |
b847eb8c DL |
1705 | Send report on `dired-x-file' version `dired-x-version,' to |
1706 | `dired-x-maintainer' at address `dired-x-help-address' listing | |
1707 | variables `dired-x-variable-list' in the message." | |
cb3fe1f0 RS |
1708 | (interactive) |
1709 | ||
b847eb8c DL |
1710 | (reporter-submit-bug-report |
1711 | dired-x-help-address ; address | |
1712 | "dired-x" ; pkgname | |
1713 | dired-x-variable-list ; varlist | |
1714 | nil nil ; pre-/post-hooks | |
1715 | "")) | |
cb3fe1f0 RS |
1716 | |
1717 | \f | |
1718 | ;; As Barry Warsaw would say: "This might be useful..." | |
1719 | (provide 'dired-x) | |
1720 | ||
ab5796a9 | 1721 | ;;; arch-tag: 71a43ba2-7a00-4793-a028-0613dd7765ae |
cb3fe1f0 | 1722 | ;;; dired-x.el ends here |