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