Mercurial > emacs
changeset 5426:a0e483109eaa
entered into RCS
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Mon, 03 Jan 1994 16:56:13 +0000 |
| parents | 3dd5ff54e1cd |
| children | cde2cde50796 |
| files | lisp/dired-x.el |
| diffstat | 1 files changed, 1597 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/lisp/dired-x.el Mon Jan 03 16:56:13 1994 +0000 @@ -0,0 +1,1597 @@ +;;; dired-x.el --- Sebastian Kremer's Extra DIRED hacked up for GNU Emacs19 + +;; Author: Sebastian Kremer <sk@thp.uni-koeln.de> +;; Lawrence R. Dodd <dodd@roebling.poly.edu> +;; Maintainer: Lawrence R. Dodd <dodd@roebling.poly.edu> +;; Version: 2.14 +;; Date: 1994/01/03 15:47:50 +;; Keywords: dired extensions + +;; Copyright (C) 1993, 1994 Free Software Foundation + +;; This file is part of GNU Emacs. + +;; GNU Emacs is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation; either version 1, or (at your option) +;; any later version. + +;; GNU Emacs is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with GNU Emacs; see the file COPYING. If not, write to +;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. + +;;; Commentary: + +;;; This is Sebastian Kremer's dired-x.el (Dired Extra), version 1.191, hacked +;;; up for GNU Emacs 19. Redundant or conflicting material has been removed +;;; or renamed in order to work properly with dired of GNU Emacs. All +;;; suggestions or comments are most welcomed. There is also a texinfo file. + +;;; BUGS: Type M-x dired-x-submit-report and a report will be generated. + +;;; INSTALLATION: In your ~/.emacs, +;;; +;;; (add-hook 'dired-load-hook +;;; (function (lambda () +;;; (load "dired-x") +;;; ;; Set variables here. For example: +;;; ;; (setq dired-guess-shell-gnutar "gtar") +;;; ))) +;;; +;;; At load time dired-x.el will install itself, redefine some functions, +;;; and bind some dired keys. See also the info pages. + +;;; User defined variables: +;;; +;;; dired-bind-vm +;;; dired-vm-read-only-folders +;;; dired-bind-jump +;;; dired-bind-info +;;; dired-bind-man +;;; dired-find-subdir +;;; dired-enable-local-variables +;;; dired-local-variables-file +;;; dired-guess-shell-gnutar +;;; dired-guess-shell-gzip-quiet +;;; dired-guess-shell-znew-switches +;;; dired-guess-shell-alist-user +;;; dired-clean-up-buffers-too +;;; dired-omit-files-p +;;; dired-omit-files +;;; dired-omit-extensions +;;; +;;; To find out more about these variables, load this file, put your cursor at +;;; the end of any of the variable names, and hit C-h v [RET]. + +;;; When loaded this code redefines the following functions of GNU Emacs +;;; +;;; Function Found in this file of GNU Emacs +;;; -------- ------------------------------- +;;; dired-clean-up-after-deletion ../lisp/dired.el +;;; dired-find-buffer-nocreate ../lisp/dired.el +;;; dired-initial-position ../lisp/dired.el +;;; dired-up-directory ../lisp/dired.el +;;; +;;; dired-add-entry ../lisp/dired-aux.el +;;; dired-read-shell-command ../lisp/dired-aux.el +;;; +;;; One drawback is that dired-x.el will load dired-aux.el as soon as dired is +;;; loaded. Thus, the advantage of separating out non-essential dired stuff +;;; into dired-aux.el and only loading when necessary will be lost. Please +;;; note also that some of the comments in dired.el and dired-aux.el are +;;; Kremer's that referred to the old dired-x.el. This now should be +;;; referring to this program. (This is a good reason to call this dired-x.el +;;; instead of dired-x19.el.) + + +;;;; Code: + +;;; LOAD. + +;;; We will redefine some functions and also need some macros so we need to +;;; load dired stuff of GNU Emacs. Since dired-aux.el does not `provide' +;;; itself, we do it here. This avoids the possibility recursive loading +;;; because of the nasty `eval-when-compile' in dired-aux.el. + +(and (not (featurep 'dired-aux)) + (load "dired-aux" nil t) + (provide 'dired-aux)) + +;;;; User-defined variables. + +(defvar dired-bind-vm nil + "*t says \"V\" in dired-mode will `dired-vm', otherwise \"V\" is `dired-rmail'. +Also, RMAIL files contain -*- rmail -*- at the top so \"f\", +`dired-advertised-find-file', will run rmail.") + +(defvar dired-bind-jump t + "*t says bind `dired-jump' to C-x C-j, otherwise do not.") + +(defvar dired-bind-man t + "*t says bind `dired-man' to \"N\" in dired-mode, otherwise do not.") + +(defvar dired-bind-info t + "*t says bind `dired-info' to \"I\" in dired-mode, otherwise do not.") + +(defvar dired-vm-read-only-folders nil + "*If t, \\[dired-vm] will visit all folders read-only. +If neither nil nor t, e.g. the symbol `if-file-read-only', only +files not writable by you are visited read-only. + +Read-only folders only work in VM 5, not in VM 4.") + +(defvar dired-omit-files-p nil + "*If non-nil, \"uninteresting\" files are not listed (buffer-local). +Use \\[dired-omit-toggle] to toggle its value. +Uninteresting files are those whose filenames match regexp `dired-omit-files', +plus those ending with extensions in `dired-omit-extensions'.") + +(defvar dired-omit-files "^#\\|\\.$" + "*Filenames matching this regexp will not be displayed (buffer-local). +This only has effect when `dired-omit-files-p' is t. +See also `dired-omit-extensions'.") + +(defvar dired-find-subdir nil ; t is pretty near to DWIM... + "*If non-nil, Dired does not make a new buffer for a directory if it +can be found (perhaps as subdir) in some existing Dired buffer. + +If there are several Dired buffers for a directory, the most recently +used is chosen. + +Dired avoids switching to the current buffer, so that if you have +a normal and a wildcard buffer for the same directory, C-x d RET will +toggle between those two.") + +(defvar dired-enable-local-variables t + "*Control use of local-variables lists in dired. +The value can be t, nil or something else. +A value of t means local-variables lists are obeyed; +nil means they are ignored; anything else means query. + +This temporarily overrides the value of `enable-local-variables' when listing +a directory. See also `dired-local-variables-file'.") + +(defvar dired-guess-shell-gnutar nil + "*If non-nil, name of GNU tar executable (e.g., \"tar\" or \"gtar\") and `z' +switch will be used for compressed or gzip'ed tar files. If no GNU tar, set +to nil: a pipe using `zcat' or `gunzip -c' will be used.") + +(defvar dired-guess-shell-gzip-quiet t + "*non-nil says pass -q to gzip overriding verbose GZIP environment.") + +(defvar dired-guess-shell-znew-switches nil + "*If non-nil, then string of switches passed to `znew', example: \"-K\"") + +(defvar dired-clean-up-buffers-too t + "*t says offer to kill buffers visiting files and dirs deleted in dired.") + +;;;; KEY BINDINGS. + +(define-key dired-mode-map "\M-o" 'dired-omit-toggle) +(define-key dired-mode-map "\M-(" 'dired-mark-sexp) +(define-key dired-mode-map "\M-!" 'dired-smart-shell-command) +(define-key dired-mode-map "T" 'dired-do-toggle) +(define-key dired-mode-map "w" 'dired-copy-filename-as-kill) +(define-key dired-mode-map "\M-g" 'dired-goto-file) +(define-key dired-mode-map "\M-G" 'dired-goto-subdir) +(define-key dired-mode-map "F" 'dired-do-find-marked-files) +(define-key dired-mode-map "Y" 'dired-do-relsymlink) +(define-key dired-mode-map "%Y" 'dired-do-relsymlink-regexp) +(define-key dired-mode-map "V" 'dired-do-run-mail) + +(if dired-bind-man + (define-key dired-mode-map "N" 'dired-man)) + +(if dired-bind-info + (define-key dired-mode-map "I" 'dired-info)) + +;;; GLOBAL BINDING. +(if dired-bind-jump + (progn + (define-key global-map "\C-x\C-j" 'dired-jump) + (define-key global-map "\C-x4\C-j" 'dired-jump-other-window))) + + +;;;; Install into appropriate hooks. + +(add-hook 'dired-mode-hook 'dired-extra-startup) +(add-hook 'dired-after-readin-hook 'dired-omit-expunge) + +(defun dired-extra-startup () + "Automatically put on dired-mode-hook to get extra dired features: +\\<dired-mode-map> + + \\[dired-do-run-mail]\t-- run mail on folder (see `dired-bind-vm') + \\[dired-info]\t-- run info on file + \\[dired-man]\t-- run man on file + \\[dired-do-find-marked-files]\t-- visit all marked files simultaneously + \\[dired-omit-toggle]\t-- toggle omitting of files + \\[dired-do-toggle]\t-- toggle marks + \\[dired-mark-sexp]\t-- mark by lisp expression + \\[dired-copy-filename-as-kill]\t-- copy the file or subdir names into the kill ring. + \t You can feed it to other commands using \\[yank]. + +For more features, see variables + + dired-bind-vm + dired-bind-jump + dired-bind-info + dired-bind-man + dired-vm-read-only-folders + dired-omit-files-p + dired-omit-files + dired-omit-extensions + dired-find-subdir + dired-enable-local-variables + dired-local-variables-file + dired-guess-shell-gnutar + dired-guess-shell-gzip-quiet + dired-guess-shell-znew-switches + dired-guess-shell-alist-user + dired-clean-up-buffers-too + +See also functions + + dired-flag-extension + dired-virtual + dired-jump + dired-man + dired-vm + dired-rmail + dired-info + dired-do-find-marked-files +" + (interactive) + + ;; These must be done in each new dired buffer. + (dired-hack-local-variables) + (dired-omit-startup)) + + +;;;; BUFFER CLEANING. + +;;; REDEFINE. +(defun dired-clean-up-after-deletion (fn) + + ;; Clean up after a deleted file or directory FN. + ;; Remove expanded subdir of deleted dir, if any. + (save-excursion (and (cdr dired-subdir-alist) + (dired-goto-subdir fn) + (dired-kill-subdir))) + + ;; Offer to kill buffer of deleted file FN. + (if dired-clean-up-buffers-too + (progn + (let ((buf (get-file-buffer fn))) + (and buf + (funcall (function y-or-n-p) + (format "Kill buffer of %s, too? " + (file-name-nondirectory fn))) + (save-excursion ; you never know where kill-buffer leaves you + (kill-buffer buf)))) + (let ((buf-list (dired-buffers-for-dir fn)) + (buf nil)) + (and buf-list + (y-or-n-p (format "Kill dired buffer%s of %s, too? " + (dired-plural-s (length buf-list)) + (file-name-nondirectory fn))) + (while buf-list + (save-excursion (kill-buffer (car buf-list))) + (setq buf-list (cdr buf-list))))))) + ;; Anything else? + ) + + +;;;; EXTENSION MARKING FUNCTIONS. + +;;; Mark files with some extension. +(defun dired-mark-extension (extension &optional marker-char) + "Mark all files with a certain extension for use in later commands. +A `.' is not automatically prepended to the string entered." + ;; EXTENSION may also be a list of extensions instead of a single one. + ;; Optional MARKER-CHAR is marker to use. + (interactive "sMarking extension: \nP") + (or (listp extension) + (setq extension (list extension))) + (dired-mark-files-regexp + (concat ".";; don't match names with nothing but an extension + "\\(" + (mapconcat 'regexp-quote extension "\\|") + "\\)$") + marker-char)) + +(defun dired-flag-extension (extension) + "In dired, flag all files with a certain extension for deletion. +A `.' is *not* automatically prepended to the string entered." + (interactive "sFlagging extension: ") + (dired-mark-extension extension dired-del-marker)) + +;;; Define some unpopular file extensions. Used for cleaning and omitting. + +(defvar dired-patch-unclean-extensions + '(".rej" ".orig") + "List of extensions of dispensable files created by the `patch' program.") + +(defvar dired-tex-unclean-extensions + '(".toc" ".log" ".aux");; these are already in completion-ignored-extensions + "List of extensions of dispensable files created by TeX.") + +(defvar dired-latex-unclean-extensions + '(".idx" ".lof" ".lot" ".glo") + "List of extensions of dispensable files created by LaTeX.") + +(defvar dired-bibtex-unclean-extensions + '(".blg" ".bbl") + "List of extensions of dispensable files created by BibTeX.") + +(defvar dired-texinfo-unclean-extensions + '(".cp" ".cps" ".fn" ".fns" ".ky" ".kys" ".pg" ".pgs" + ".tp" ".tps" ".vr" ".vrs") + "List of extensions of dispensable files created by texinfo.") + +(defun dired-clean-patch () + "Flag dispensable files created by patch for deletion. +See variable `dired-patch-unclean-extensions'." + (interactive) + (dired-flag-extension dired-patch-unclean-extensions)) + +(defun dired-clean-tex () + "Flag dispensable files created by tex etc. for deletion. +See variable `dired-texinfo-unclean-extensions', `dired-latex-unclean-extensions', +`dired-bibtex-unclean-extensions' and `dired-texinfo-unclean-extensions'." + (interactive) + (dired-flag-extension (append dired-texinfo-unclean-extensions + dired-latex-unclean-extensions + dired-bibtex-unclean-extensions + dired-tex-unclean-extensions))) + +(defun dired-clean-dvi () + "Flag dispensable `.dvi' files from tex etc. for deletion." + (interactive) + (dired-flag-extension ".dvi")) + + +;;;; JUMP. + +(defun dired-jump (&optional other-window) + "Jump to dired buffer corresponding to current buffer. +If in a file, dired the current directory and move to file's line. +If in dired already, pop up a level and goto old directory's line. +In case the proper dired file line cannot be found, refresh the dired +buffer and try again." + (interactive "P") + (let* ((file buffer-file-name) + (dir (if file (file-name-directory file) default-directory))) + (if (eq major-mode 'dired-mode) + (progn + (setq dir (dired-current-directory)) + (dired-up-directory other-window) + (or (dired-goto-file dir) + ;; refresh and try again + (progn + (dired-insert-subdir (file-name-directory dir)) + (dired-goto-file dir)))) + (if other-window + (dired-other-window dir) + (dired dir)) + (if file + (or (dired-goto-file file) + ;; refresh and try again + (progn + (dired-insert-subdir (file-name-directory file)) + (dired-goto-file file))))))) + +(defun dired-jump-other-window () + "Like \\[dired-jump] (dired-jump) but in other window." + (interactive) + (dired-jump t)) + +;;; REDEFINE. +;;; This replaces the version in dired.el +;;; It simply adds the OTHER-WINDOW option to the one in dired.el. +(defun dired-up-directory (&optional other-window) + "Run dired on parent directory of current directory. +Find the parent directory either in this buffer or another buffer. +Finds in current window or in other window with optional OTHER-WINDOW. +Creates a buffer if necessary." + (interactive "P") + (let* ((dir (dired-current-directory)) + (up (file-name-directory (directory-file-name dir)))) + (or (dired-goto-file (directory-file-name dir)) + ;; Only try dired-goto-subdir if buffer has more than one dir. + (and (cdr dired-subdir-alist) + (dired-goto-subdir up)) + (progn + (if other-window + (dired-other-window up) + (dired up)) + (dired-goto-file dir))))) + + +;;;; TOGGLE. +;;; Toggle marked files with unmarked files. + +(defun dired-do-toggle () + "Toggle marks. +That is, currently marked files become unmarked and vice versa. +Files marked with other flags (such as `D') are not affected. +`.' and `..' are never toggled. +As always, hidden subdirs are not affected." + (interactive) + (save-excursion + (goto-char (point-min)) + (let (buffer-read-only) + (while (not (eobp)) + (or (dired-between-files) + (looking-at dired-re-dot) + ;; use subst instead of insdel because it does not move + ;; the gap and thus should be faster and because + ;; other characters are left alone automatically + (apply 'subst-char-in-region + (point) (1+ (point)) + (if (eq ?\040 (following-char)) ; SPC + (list ?\040 dired-marker-char) + (list dired-marker-char ?\040)))) + (forward-line 1))))) + + +;;;; COPY NAMES OF MARKED FILES INTO KILL-RING. + +(defun dired-copy-filename-as-kill (&optional arg) + "Copy names of marked (or next ARG) files into the kill ring. +The names are separated by a space. +With a zero prefix arg, use the complete pathname of each marked file. +With \\[universal-argument], use the relative pathname of each marked file. + +If on a subdir headerline, use subdirname instead; prefix arg is ignored +in this case. + +You can then feed the file name(s) to other commands with \\[yank]." + (interactive "P") + (let ((string + (or (dired-get-subdir) + (mapconcat (function identity) + (if arg + (cond ((zerop (prefix-numeric-value arg)) + (dired-get-marked-files)) + ((integerp arg) + (dired-get-marked-files 'no-dir arg)) + (t ; else a raw arg + (dired-get-marked-files t))) + (dired-get-marked-files 'no-dir)) + " ")))) + (kill-new string) + (message "%s" string))) + + +;;;; OMITTING. + +;;; Enhanced omitting of lines from directory listings. +;;; Marked files are never omitted. + +;; should probably get rid of this and always use 'no-dir. +;; sk 28-Aug-1991 09:37 +(defvar dired-omit-localp 'no-dir + "The LOCALP argument dired-omit-expunge passes to dired-get-filename. +If it is 'no-dir, omitting is much faster, but you can only match +against the basename of the file. Set it to nil if you need to match the +whole pathname.") + +;; \017=^O for Omit - other packages can chose other control characters. +(defvar dired-omit-marker-char ?\017 + "Temporary marker used by by dired-omit. +Should never be used as marker by the user or other packages.") + +(defun dired-omit-startup () + (make-local-variable 'dired-omit-files-p) + (or (assq 'dired-omit-files-p minor-mode-alist) + (setq minor-mode-alist + (append '((dired-omit-files-p " Omit")) minor-mode-alist)))) + +(defun dired-omit-toggle (&optional flag) + "Toggle between displaying and omitting files matching `dired-omit-files'. +With an arg, and if omitting was off, don't toggle and just mark the + files but don't actually omit them. +With an arg, and if omitting was on, turn it off but don't refresh the buffer." + (interactive "P") + (if flag + (if dired-omit-files-p + (setq dired-omit-files-p (not dired-omit-files-p)) + (dired-mark-unmarked-files (dired-omit-regexp) nil nil + dired-omit-localp)) + ;; no FLAG + (setq dired-omit-files-p (not dired-omit-files-p)) + (if (not dired-omit-files-p) + (revert-buffer) + ;; this will mention how many were omitted: + (dired-omit-expunge)))) + +(defvar dired-omit-extensions + (append completion-ignored-extensions + dired-latex-unclean-extensions + dired-bibtex-unclean-extensions + dired-texinfo-unclean-extensions) + "If non-nil, a list of extensions (strings) to omit from Dired +listings. Defaults to the elements of +`completion-ignored-extensions', `dired-latex-unclean-extensions', +`dired-bibtex-unclean-extensions' and `dired-texinfo-unclean-extensions'.") + +(defun dired-omit-expunge (&optional regexp) + "Erases all unmarked files matching REGEXP. +Does nothing if global variable `dired-omit-files-p' is nil. +If REGEXP is nil or not specified, uses `dired-omit-files', and also omits + filenames ending in `dired-omit-extensions'. +If REGEXP is the empty string, this function is a no-op. + +This functions works by temporarily binding `dired-marker-char' to +`dired-omit-marker-char' and calling `dired-do-kill-lines'." + (interactive "sOmit files (regexp): ") + (if dired-omit-files-p + (let ((omit-re (or regexp (dired-omit-regexp))) + count) + (or (string= omit-re "") + (let ((dired-marker-char dired-omit-marker-char)) + (message "Omitting...") + (if (dired-mark-unmarked-files omit-re nil nil dired-omit-localp) + (progn + (setq count (dired-do-kill-lines nil "Omitted %d line%s.")) + ;; Force an update of modeline. + (set-buffer-modified-p (buffer-modified-p))) + (message "(Nothing to omit)")))) + count))) + +(defun dired-omit-regexp () + (concat (if dired-omit-files (concat "\\(" dired-omit-files "\\)") "") + (if (and dired-omit-files dired-omit-extensions) "\\|" "") + (if dired-omit-extensions + (concat ".";; a non-extension part should exist + "\\(" + (mapconcat 'regexp-quote dired-omit-extensions "\\|") + "\\)$") + ""))) + +;; Returns t if any work was done, nil otherwise. +(defun dired-mark-unmarked-files (regexp msg &optional unflag-p localp) + "Marks unmarked files matching REGEXP, displaying MSG. +REGEXP is matched against the complete pathname. +Does not re-mark files which already have a mark. +With prefix argument, unflag all those files. +Second optional argument LOCALP is as in `dired-get-filename'." + (interactive "P") + (let ((dired-marker-char (if unflag-p ?\ dired-marker-char))) + (dired-mark-if + (and + ;; not already marked + (looking-at " ") + ;; uninteresting + (let ((fn (dired-get-filename localp t))) + (and fn (string-match regexp fn)))) + msg))) + +;;; REDEFINE. +(defun dired-omit-new-add-entry (filename &optional marker-char) + ;; This redefines dired-aux.el's dired-add-entry to avoid calling ls for + ;; files that are going to be omitted anyway. + (if dired-omit-files-p + ;; perhaps return t without calling ls + (let ((omit-re (dired-omit-regexp))) + (if (or (string= omit-re "") + (not + (string-match omit-re + (cond + ((eq 'no-dir dired-omit-localp) + filename) + ((eq t dired-omit-localp) + (dired-make-relative filename)) + (t + (dired-make-absolute + filename + (file-name-directory filename))))))) + ;; if it didn't match, go ahead and add the entry + (dired-omit-old-add-entry filename marker-char) + ;; dired-add-entry returns t for success, perhaps we should + ;; return file-exists-p + t)) + ;; omitting is not turned on at all + (dired-omit-old-add-entry filename marker-char))) + +;;; REDEFINE. +;;; Redefine dired-aux.el's version of `dired-add-entry' +;;; Save old defun if not already done: +(or (fboundp 'dired-omit-old-add-entry) + (fset 'dired-omit-old-add-entry (symbol-function 'dired-add-entry))) +;; Redefine it. +(fset 'dired-add-entry 'dired-omit-new-add-entry) + + +;;;; VIRTUAL DIRED MODE. + +;;; For browsing `ls -lR' listings in a dired-like fashion. + +(fset 'virtual-dired 'dired-virtual) +(defun dired-virtual (dirname &optional switches) + "Put this buffer into Virtual Dired mode. + +In Virtual Dired mode, all commands that do not actually consult the +filesystem will work. + +This is useful if you want to peruse and move around in an ls -lR +output file, for example one you got from an ftp server. With +ange-ftp, you can even dired a directory containing an ls-lR file, +visit that file and turn on virtual dired mode. But don't try to save +this file, as dired-virtual indents the listing and thus changes the +buffer. + +If you have save a Dired buffer in a file you can use \\[dired-virtual] to +resume it in a later session. + +Type \\<dired-mode-map>\\[revert-buffer] in the +Virtual Dired buffer and answer `y' to convert the virtual to a real +dired buffer again. You don't have to do this, though: you can relist +single subdirs using \\[dired-do-redisplay]. +" + + ;; DIRNAME is the top level directory of the buffer. It will become + ;; its `default-directory'. If nil, the old value of + ;; default-directory is used. + + ;; Optional SWITCHES are the ls switches to use. + + ;; Shell wildcards will be used if there already is a `wildcard' + ;; line in the buffer (thus it is a saved Dired buffer), but there + ;; is no other way to get wildcards. Insert a `wildcard' line by + ;; hand if you want them. + + (interactive + (list (read-string "Virtual Dired directory: " (dired-virtual-guess-dir)))) + (goto-char (point-min)) + (or (looking-at " ") + ;; if not already indented, do it now: + (indent-region (point-min) (point-max) 2)) + (or dirname (setq dirname default-directory)) + (setq dirname (expand-file-name (file-name-as-directory dirname))) + (setq default-directory dirname) ; contains no wildcards + (let ((wildcard (save-excursion + (goto-char (point-min)) + (forward-line 1) + (and (looking-at "^ wildcard ") + (buffer-substring (match-end 0) + (progn (end-of-line) (point))))))) + (if wildcard + (setq dirname (expand-file-name wildcard default-directory)))) + ;; If raw ls listing (not a saved old dired buffer), give it a + ;; decent subdir headerline: + (goto-char (point-min)) + (or (looking-at dired-subdir-regexp) + (dired-insert-headerline default-directory)) + (dired-mode dirname (or switches dired-listing-switches)) + (setq mode-name "Virtual Dired" + revert-buffer-function 'dired-virtual-revert) + (set (make-local-variable 'dired-subdir-alist) nil) + (dired-build-subdir-alist) + (goto-char (point-min)) + (dired-initial-position dirname)) + +(defun dired-virtual-guess-dir () + + ;; Guess and return appropriate working directory of this buffer, + ;; assumed to be in Dired or ls -lR format. + ;; The guess is based upon buffer contents. + ;; If nothing could be guessed, returns nil. + + (let ((regexp "^\\( \\)?\\([^ \n\r]*\\)\\(:\\)[\n\r]") + (subexpr 2)) + (goto-char (point-min)) + (cond ((looking-at regexp) + ;; If a saved dired buffer, look to which dir and + ;; perhaps wildcard it belongs: + (let ((dir (buffer-substring (match-beginning subexpr) + (match-end subexpr)))) + (file-name-as-directory dir))) + ;; Else no match for headerline found. It's a raw ls listing. + ;; In raw ls listings the directory does not have a headerline + ;; try parent of first subdir, if any + ((re-search-forward regexp nil t) + (file-name-directory + (directory-file-name + (file-name-as-directory + (buffer-substring (match-beginning subexpr) + (match-end subexpr)))))) + (t ; if all else fails + nil)))) + + +(defun dired-virtual-revert (&optional arg noconfirm) + (if (not + (y-or-n-p "Cannot revert a Virtual Dired buffer - switch to Real Dired mode? ")) + (error "Cannot revert a Virtual Dired buffer.") + (setq mode-name "Dired" + revert-buffer-function 'dired-revert) + (revert-buffer))) + +;; A zero-arg version of dired-virtual. +;; You need my modified version of set-auto-mode for the +;; `buffer-contents-mode-alist'. +;; Or you use infer-mode.el and infer-mode-alist, same syntax. +(defun dired-virtual-mode () + "Put current buffer into virtual dired mode (see `dired-virtual'). +Useful on `buffer-contents-mode-alist' (which see) with the regexp + + \"^ \\(/[^ /]+\\)/?+:$\" + +to put saved dired buffers automatically into virtual dired mode. + +Also useful for `auto-mode-alist' (which see) like this: + + \(setq auto-mode-alist (cons '(\"[^/]\\.dired$\" . dired-virtual-mode) + auto-mode-alist)\)" + (interactive) + (dired-virtual (dired-virtual-guess-dir))) + + +;;;; SMART SHELL. + +;;; An Emacs buffer can have but one working directory, stored in the +;;; buffer-local variable `default-directory'. A Dired buffer may have +;;; several subdirectories inserted, but still has but one working directory: +;;; that of the top level Dired directory in that buffer. For some commands +;;; it is appropriate that they use the current Dired directory instead of +;;; `default-directory', e.g., `find-file' and `compile'. This is a general +;;; mechanism is provided for special handling of the working directory in +;;; special major modes. + +;; It's easier to add to this alist than redefine function +;; default-directory while keeping the old information. +(defconst default-directory-alist + '((dired-mode . (if (fboundp 'dired-current-directory) + (dired-current-directory) + default-directory))) + "Alist of major modes and their opinion on default-directory, as a +lisp expression to evaluate. A resulting value of nil is ignored in +favor of default-directory.") + +(defun default-directory () + "Usage like variable `default-directory', but knows about the special +cases in variable `default-directory-alist' (which see)." + (or (eval (cdr (assq major-mode default-directory-alist))) + default-directory)) + +(defun dired-smart-shell-command (cmd &optional insert) + "Like function `shell-command', but in the current Tree Dired directory." + (interactive "sShell command: \nP") + (let ((default-directory (default-directory))) + (shell-command cmd insert))) + + +;;;; LOCAL VARIABLES FOR DIRED BUFFERS. + +;;; Brief Description: +;;; +;;; * `dired-extra-startup' is part of the `dired-mode-hook'. +;;; +;;; * `dired-extra-startup' calls `dired-hack-local-variables' +;;; +;;; * `dired-hack-local-variables' checks the value of +;;; `dired-local-variables-file' +;;; +;;; * Check if `dired-local-variables-file' is a non-nil string and is a +;;; filename found in the directory of the Dired Buffer being created. +;;; +;;; * If `dired-local-variables-file' satisfies the above, then temporarily +;;; include it in the Dired Buffer at the bottom. +;;; +;;; * Set `enable-local-variables' temporarily to the user variable +;;; `dired-enable-local-variables' and run `hack-local-variables' on the +;;; Dired Buffer. + +(defvar dired-local-variables-file ".dired" + "Filename, as string, containing local dired buffer variables to be hacked. +If this file found in current directory, then it will be inserted into dired +buffer and `hack-local-variables' will be run. See Emacs Info pages for more +information on local variables. See also `dired-enable-local-variables'.") + +(defun dired-hack-local-variables () + "Evaluate local variables in `dired-local-variables-file' for dired buffer." + (if (and dired-local-variables-file + (stringp dired-local-variables-file) + (file-exists-p dired-local-variables-file)) + (let ((opoint (point-max)) + buffer-read-only + ;; In case user has `enable-local-variables' set to nil we + ;; override it locally with dired's variable. + (enable-local-variables dired-enable-local-variables)) + ;; Insert 'em. + (save-excursion + (goto-char opoint) + (insert "\^L\n") + (insert-file-contents dired-local-variables-file)) + ;; Hack 'em. + (let ((buffer-file-name dired-local-variables-file)) + (hack-local-variables)) + ;; Make sure that the modeline shows the proper information. + (dired-sort-set-modeline) + ;; Delete this stuff: `eobp' is used to find last subdir by dired.el. + (delete-region opoint (point-max))))) + +(defun dired-omit-here-always () + "Creates `dired-local-variables-file' for omitting and reverts directory. +Sets dired-omit-file-p to t in a local variables file that is readable by +dired." + (interactive) + (if (file-exists-p dired-local-variables-file) + (message "File `./%s' already exists." dired-local-variables-file) + + ;; Create `dired-local-variables-file'. + (save-excursion + (set-buffer (get-buffer-create " *dot-dired*")) + (erase-buffer) + (insert "Local Variables:\ndired-omit-files-p: t\nEnd:\n") + (write-file dired-local-variables-file) + (kill-buffer (current-buffer))) + + ;; Run extra-hooks and revert directory. + (dired-extra-startup) + (dired-revert))) + + +;;;; GUESS SHELL COMMAND. + +;;; Brief Description: +;;; +;;; `dired-do-shell-command' is bound to `!' by dired.el. +;;; +;;; * Redefine `dired-do-shell-command' so it calls +;;; `dired-guess-shell-command'. +;;; +;;; * `dired-guess-shell-command' calls `dired-guess-default' with list of +;;; marked files. +;;; +;;; * Parse `dired-guess-shell-alist-user' and +;;; `dired-guess-shell-alist-default' (in that order) for the first REGEXP +;;; that matches the first file in the file list. +;;; +;;; * If the REGEXP matches all the entries of the file list then evaluate +;;; COMMAND, which is either a string or an elisp expression returning a +;;; string. COMMAND may be a list of commands. +;;; +;;; * Return this command to `dired-guess-shell-command' which prompts user +;;; with it. The list of commands are temporaily put into the history list. +;;; If a command is used successfully then it is stored permanently in +;;; `dired-shell-command-history'. + +;;; Guess what shell command to apply to a file. +(defvar dired-shell-command-history nil + "History list for commands that read dired-shell commands.") + +;;; Default list of shell commands. + +;;; NOTE: Use `gunzip -c' instead of `zcat' on `.gz' files. Some do not +;;; install GNU zip's version of zcat. + +(defvar dired-guess-shell-alist-default + (list + (list "\\.tar$" '(if dired-guess-shell-gnutar + (concat dired-guess-shell-gnutar " xvf") + "tar xvf")) + + ;; REGEXPS for compressed archives must come before the .Z rule to + ;; be recognized: + (list "\\.tar\\.Z$" + ;; Untar it. + '(if dired-guess-shell-gnutar + (concat dired-guess-shell-gnutar " zxvf") + (concat "zcat * | tar xvf -")) + ;; Optional conversion to gzip format. + '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") + " " dired-guess-shell-znew-switches)) + + ;; gzip'ed archives + (list "\\.tar\\.g?z$" + '(if dired-guess-shell-gnutar + (concat dired-guess-shell-gnutar " zxvf") + (concat "gunzip -qc * | tar xvf -")) + ;; Optional decompression. + '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q" ""))) + + '("\\.shar.Z$" "zcat * | unshar") + '("\\.shar.g?z$" "gunzip -qc * | unshar") + + '("\\.ps$" "ghostview" "xv" "lpr") + (list "\\.ps.g?z$" "gunzip -qc * | ghostview -" + ;; Optional decompression. + '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) + (list "\\.ps.Z$" "zcat * | ghostview -" + ;; Optional conversion to gzip format. + '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") + " " dired-guess-shell-znew-switches)) + '("\\.patch$" "cat * | patch") + '("\\.patch.g?z$" "gunzip -qc * | patch") + (list "\\.patch.Z$" "zcat * | patch" + ;; Optional conversion to gzip format. + '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") + " " dired-guess-shell-znew-switches)) + + '("\\.dvi$" "xdvi" "dvips") ; preview and printing + '("\\.au$" "play") ; play Sun audiofiles + '("\\.mpg$" "mpeg_play") + '("\\.uu$" "uudecode") ; for uudecoded files + '("\\.hqx$" "mcvert") + '("\\.sh$" "sh") ; execute shell scripts + '("\\.xbm$" "bitmap") ; view X11 bitmaps + '("\\.gp$" "gnuplot") + '("\\.p[bgpn]m$" "xv") + '("\\.gif$" "xv") ; view gif pictures + '("\\.tif$" "xv") + '("\\.jpg$" "xv") + '("\\.fig$" "xfig") ; edit fig pictures + '("\\.out$" "xgraph") ; for plotting purposes. + '("\\.tex$" "latex" "tex") + '("\\.texi\\(nfo\\)?$" "makeinfo" "texi2dvi") + + ;; Some other popular archivers. + '("\\.zoo$" "zoo x//") + '("\\.zip$" "unzip") + '("\\.lzh$" "lharc x") + '("\\.arc$" "arc x") + '("\\.shar$" "unshar") + + ;; Compression. + (list "\\.g?z$" '(concat "gunzip" (if dired-guess-shell-gzip-quiet " -q"))) + (list "\\.Z$" "uncompress" + ;; Optional conversion to gzip format. + '(concat "znew" (if dired-guess-shell-gzip-quiet " -q") + " " dired-guess-shell-znew-switches)) + ) + + "Default alist used for shell command guessing. +See `dired-guess-shell-alist-user'") + +(defvar dired-guess-shell-alist-user nil + "User-defined alist of rules for suggested commands. These rules take +precedence over the predefined rules in the variable +`dired-guess-shell-alist-default' (to which they are prepended). + +Each element of this list looks like + + \(REGEXP COMMAND...\) + +where each COMMAND can either be a string or a lisp expression that evaluates +to a string. If several COMMANDs are given, the first one will be the default +and the rest will be added temporarily to the history and can be retrieved +with \\[previous-history-element] (M-p) . + +You can set this variable in your ~/.emacs. For example, to add rules for +`.foo' and `.bar' files, write + + \(setq dired-guess-shell-alist-user + (list (list \"\\\\.foo$\" \"FOO-COMMAND\");; fixed rule + ;; possibly more rules ... + (list \"\\\\.bar$\";; rule with condition test + '(if condition + \"BAR-COMMAND-1\" + \"BAR-COMMAND-2\")))\) +") + +(defun dired-guess-default (files) + + ;; Guess a shell commands for FILES. Return command or list of commands. + ;; See `dired-guess-shell-alist-user'. + + (let* ((case-fold-search nil) ; case-sensitive matching + ;; Prepend the user's alist to the default alist. + (alist (append dired-guess-shell-alist-user + dired-guess-shell-alist-default)) + (file (car files)) + (flist (cdr files)) + elt regexp cmds) + + ;; Find the first match in the alist for first file in FILES. + (while alist + (setq elt (car alist) + regexp (car elt) + alist (cdr alist)) + (if (string-match regexp file) + (setq cmds (cdr elt) + alist nil))) + + ;; If more than one file, see if all of FILES match regular expression. + (while (and flist + (string-match regexp (car flist))) + (setq flist (cdr flist))) + + ;; If flist is still non-nil, then do not guess since this means that not + ;; all the files in FILES were matched by the regexp. + (setq cmds (and (not flist) cmds)) + + ;; Return commands or nil if flist is still non-nil. + ;; Evaluate the commands in order that any logical testing will be done. + (cond ((not (cdr cmds)) + (eval (car cmds))) ; single command + (t + (mapcar (function eval) cmds))))) + +(defun dired-guess-shell-command (prompt files) + + ;; Ask user with PROMPT for a shell command, guessing a default from FILES. + + (let ((default (dired-guess-default files)) + default-list old-history val (failed t)) + + (if (null default) + ;; Nothing to guess + (read-from-minibuffer prompt nil nil nil 'dired-shell-command-history) + + ;; Save current history list + (setq old-history dired-shell-command-history) + + (if (listp default) + + ;; More than one guess + (setq default-list default + default (car default) + prompt (concat + prompt + (format "{%d guesses} " (length default-list)))) + + ;; Just one guess + (setq default-list (list default))) + + ;; Push all guesses onto history so that they can be retrieved with M-p + ;; and put the first guess in the prompt but not in the initial value. + (setq dired-shell-command-history + (append default-list dired-shell-command-history) + prompt (concat prompt (format "[%s] " default))) + + ;; The unwind-protect returns VAL, and we too. + (unwind-protect + ;; BODYFORM + (progn + (setq val (read-from-minibuffer prompt nil nil nil + 'dired-shell-command-history) + failed nil) + ;; If we got a return, then use default. + (if (equal val "") + (setq val default)) + val) + + ;; UNWINDFORMS + ;; Undo pushing onto the history list so that an aborted + ;; command doesn't get the default in the next command. + (setq dired-shell-command-history old-history) + (if (not failed) + (or (equal val (car-safe dired-shell-command-history)) + (setq dired-shell-command-history + (cons val dired-shell-command-history)))))))) + + +;;; REDEFINE. +;;; Redefine dired-aux.el's version: +(defun dired-read-shell-command (prompt arg files) +;; "Read a dired shell command prompting with PROMPT (using read-string). +;;ARG is the prefix arg and may be used to indicate in the prompt which +;; files are affected. +;;This is an extra function so that you can redefine it, e.g., to use gmhist." + (dired-mark-pop-up + nil 'shell files + 'dired-guess-shell-command + (format prompt (dired-mark-prompt arg files)) ; PROMPT + files)) ; FILES + + +;;;; RELATIVE SYMBOLIC LINKS. + +(defvar dired-keep-marker-relsymlink ?S + "See variable `dired-keep-marker-move'.") + +(defun dired-make-relative-symlink (file1 file2 &optional ok-if-already-exists) + "Three arguments: FILE1 FILE2 &optional OK-IF-ALREADY-EXISTS +Make a symbolic link (pointing to FILE1) in FILE2. +The link is relative (if possible), for example + + \"/vol/tex/bin/foo\" \"/vol/local/bin/foo\" + +results in + + \"../../tex/bin/foo\" \"/vol/local/bin/foo\" +" + (interactive "FRelSymLink: \nFRelSymLink %s: \np") + (let (name1 name2 len1 len2 (index 0) sub) + (setq file1 (expand-file-name file1) + file2 (expand-file-name file2) + len1 (length file1) + len2 (length file2)) + ;; Find common initial pathname components: + (let (next) + (while (and (setq next (string-match "/" file1 index)) + (setq next (1+ next)) + (< next (min len1 len2)) + ;; For the comparison, both substrings must end in + ;; `/', so NEXT is *one plus* the result of the + ;; string-match. + ;; E.g., consider the case of linking "/tmp/a/abc" + ;; to "/tmp/abc" erronously giving "/tmp/a" instead + ;; of "/tmp/" as common initial component + (string-equal (substring file1 0 next) + (substring file2 0 next))) + (setq index next)) + (setq name2 file2 + sub (substring file1 0 index) + name1 (substring file1 index))) + (if (string-equal sub "/") + ;; No common initial pathname found + (setq name1 file1) + ;; Else they have a common parent directory + (let ((tem (substring file2 index)) + (start 0) + (count 0)) + ;; Count number of slashes we must compensate for ... + (while (setq start (string-match "/" tem start)) + (setq count (1+ count) + start (1+ start))) + ;; ... and prepend a "../" for each slash found: + (while (> count 0) + (setq count (1- count) + name1 (concat "../" name1))))) + (make-symbolic-link + (directory-file-name name1) ; must not link to foo/ + ; (trailing slash!) + name2 ok-if-already-exists))) + +(defun dired-do-relsymlink (&optional arg) + "Relative symlink all marked (or next ARG) files into a directory, +or make a relative symbolic link to the current file. +This creates relative symbolic links like + + foo -> ../bar/foo + +not absolute ones like + + foo -> /ugly/path/that/may/change/any/day/bar/foo" + (interactive "P") + (dired-do-create-files 'relsymlink (function dired-make-relative-symlink) + "RelSymLink" arg dired-keep-marker-relsymlink)) + +(defun dired-do-relsymlink-regexp (regexp newname &optional whole-path) + "RelSymlink all marked files containing REGEXP to NEWNAME. +See functions `dired-do-rename-regexp' and `dired-do-relsymlink' +for more info." + (interactive (dired-mark-read-regexp "RelSymLink")) + (dired-do-create-files-regexp + (function dired-make-relative-symlink) + "RelSymLink" nil regexp newname whole-path dired-keep-marker-relsymlink)) + + +;;;; VISIT ALL MARKED FILES SIMULTANEOUSLY. + +;;; Brief Description: +;;; +;;; `dired-do-find-marked-files' is bound to `F' by dired-x.el. +;;; +;;; * Use `dired-get-marked-files' to collect the marked files in the current +;;; Dired Buffer into a list of filenames `FILE-LIST'. +;;; +;;; * Pass FILE-LIST to `dired-simultaneous-find-file' all with +;;; `dired-do-find-marked-files''s prefix argument NOSELECT. +;;; +;;; * `dired-simultaneous-find-file' runs through FILE-LIST decrementing the +;;; list each time. +;;; +;;; * If NOSELECT is non-nil then just run `find-file-noselect' on each +;;; element of FILE-LIST. +;;; +;;; * If NOSELECT is nil then calculate the `size' of the window for each file +;;; by dividing the `window-height' by length of FILE-LIST. Thus, `size' is +;;; cognizant of the window-configuration. +;;; +;;; * If `size' is too small abort, otherwise run `find-file' on each element +;;; of FILE-LIST giving each a window of height `size'. + +(defun dired-do-find-marked-files (&optional noselect) + "Find all marked files displaying all of them simultaneously. +With optional NOSELECT just find files but do not select them. + +The current window is split across all files marked, as evenly as possible. +Remaining lines go to bottom-most window. The number of files that can be +displayed this way is restricted by the height of the current window and +`window-min-height'. + +To keep dired buffer displayed, type \\[split-window-vertically] first. +To display just marked files, type \\[delete-other-windows] first." + + (interactive "P") + (dired-simultaneous-find-file (dired-get-marked-files) noselect)) + +(defun dired-simultaneous-find-file (file-list noselect) + + ;; Visit all files in FILE-LIST and display them simultaneously. The + ;; current window is split across all files in FILE-LIST, as evenly as + ;; possible. Remaining lines go to the bottom-most window. The number of + ;; files that can be displayed this way is restricted by the height of the + ;; current window and the variable `window-min-height'. With non-nil + ;; NOSELECT the files are merely found but not selected. + + ;; We don't make this function interactive because it is usually too clumsy + ;; to specify FILE-LIST interactively unless via dired. + + (let (size) + + (if noselect + ;; Do not select the buffer. + (find-file-noselect (car file-list)) + + ;; We will have to select the buffer. Calculate and check window size. + (setq size (/ (window-height) (length file-list))) + (or (<= window-min-height size) + (error "Too many files to visit simultaneously. Try C-u prefix.")) + (find-file (car file-list))) + + ;; Decrement. + (setq file-list (cdr file-list)) + + (while file-list + + (if noselect + ;; Do not select the buffer. + (find-file-noselect (car file-list)) + + ;; Vertically split off a window of desired size. Upper window will + ;; have SIZE lines. Select lower (larger) window. We split it again. + (select-window (split-window nil size)) + (find-file (car file-list))) + + ;; Decrement. + (setq file-list (cdr file-list))))) + + +;;;; MISCELLANEOUS COMMANDS. + +;;; Run man on files. + +(defun dired-man () + "Run man on this file." + (interactive) + (let* ((file (dired-get-filename)) + (man-buffer (generate-new-buffer + (format "*man %s*" (file-name-nondirectory file))))) + (save-excursion + (set-buffer man-buffer) + (message "Expanding manual page...") + (call-process shell-file-name nil t nil "-c" + (concat " nroff -man -h " file)) + (message "Expanding manual page...cleaning...") + (call-process-region (point-min) (point-max) + shell-file-name t t nil "-c" " col -b") + (goto-char (point-min)) + (set-buffer-modified-p nil)) + (display-buffer man-buffer 'not-this-window)) + (message "Expanding manual page...cleaning...done")) + +;;; Run Info on files. + +(defun dired-info () + "Run info on this file." + (interactive) + (info (dired-get-filename))) + +;;; Run mail on mail folders. + +(defun dired-vm (&optional read-only) + "Run VM on this file. +With prefix arg, visit folder read-only (this requires at least VM 5). +See also variable `dired-vm-read-only-folders'." + (interactive "P") + (let ((dir (dired-current-directory)) + (fil (dired-get-filename))) + ;; take care to supply 2nd arg only if requested - may still run VM 4! + (cond (read-only (vm-visit-folder fil t)) + ((eq t dired-vm-read-only-folders) (vm-visit-folder fil t)) + ((null dired-vm-read-only-folders) (vm-visit-folder fil)) + (t (vm-visit-folder fil (not (file-writable-p fil))))) + ;; so that pressing `v' inside VM does prompt within current directory: + (set (make-local-variable 'vm-folder-directory) dir))) + +(defun dired-rmail () + "Run RMAIL on this file." + (interactive) + (rmail (dired-get-filename))) + +(defun dired-do-run-mail () + "If `dired-bind-vm' is t, then function `dired-vm', otherwise `dired-rmail'." + (interactive) + (if dired-bind-vm + ;; Read mail folder using vm. + (dired-vm) + ;; Read mail folder using rmail. + (dired-rmail))) + + +;;;; MISCELLANEOUS INTERNAL FUNCTIONS. + +(or (fboundp 'dired-old-find-buffer-nocreate) + (fset 'dired-old-find-buffer-nocreate + (symbol-function 'dired-find-buffer-nocreate))) + +;;; REDEFINE. +;;; Redefines dired.el's version of `dired-find-buffer-nocreate' +(defun dired-find-buffer-nocreate (dirname) + (if dired-find-subdir + (let* ((cur-buf (current-buffer)) + (buffers (nreverse (dired-buffers-for-dir dirname))) + (cur-buf-matches (and (memq cur-buf buffers) + ;; wildcards must match, too: + (equal dired-directory dirname)))) + ;; We don't want to switch to the same buffer--- + (setq buffers (delq cur-buf buffers));;need setq with delq + (or (car (sort buffers (function dired-buffer-more-recently-used-p))) + ;; ---unless it's the only possibility: + (and cur-buf-matches cur-buf))) + (dired-old-find-buffer-nocreate dirname))) + +;; This should be a builtin +(defun dired-buffer-more-recently-used-p (buffer1 buffer2) + "Return t if BUFFER1 is more recently used than BUFFER2." + (if (equal buffer1 buffer2) + nil + (let ((more-recent nil) + (list (buffer-list))) + (while (and list + (not (setq more-recent (equal buffer1 (car list)))) + (not (equal buffer2 (car list)))) + (setq list (cdr list))) + more-recent))) + +;;; Same thing as `dired-buffers-for-dir' of dired.el? - lrd 11/23/93 +;;; (defun dired-buffers-for-dir-exact (dir) +;;; ;; Return a list of buffers that dired DIR (a directory or wildcard) +;;; ;; at top level, or as subdirectory. +;;; ;; Top level matches must match the wildcard part too, if any. +;;; ;; The list is in reverse order of buffer creation, most recent last. +;;; ;; As a side effect, killed dired buffers for DIR are removed from +;;; ;; dired-buffers. +;;; (let ((alist dired-buffers) result elt) +;;; (while alist +;;; (setq elt (car alist) +;;; alist (cdr alist)) +;;; (let ((buf (cdr elt))) +;;; (if (buffer-name buf) +;;; ;; Top level must match exactly against dired-directory in +;;; ;; case one of them is a wildcard. +;;; (if (or (equal dir (save-excursion (set-buffer buf) +;;; dired-directory)) +;;; (assoc dir (save-excursion (set-buffer buf) +;;; dired-subdir-alist))) +;;; (setq result (cons buf result))) +;;; ;; else buffer is killed - clean up: +;;; (setq dired-buffers (delq elt dired-buffers))))) +;;; result)) + +;;; REDEFINE. +;;; Redefines dired.el's version of `dired-initial-position' +(defun dired-initial-position (dirname) + (end-of-line) + (if dired-find-subdir (dired-goto-subdir dirname)) ; new + (if dired-trivial-filenames (dired-goto-next-nontrivial-file))) + + +;; Does anyone use this? - lrd 6/29/93. +(defun dired-mark-sexp (predicate &optional unflag-p) + "Mark files for which PREDICATE returns non-nil. +With a prefix arg, unflag those files instead. + +PREDICATE is a lisp expression that can refer to the following symbols: + + inode [integer] the inode of the file (only for ls -i output) + s [integer] the size of the file for ls -s output + (ususally in blocks or, with -k, in KByte) + mode [string] file permission bits, e.g. \"-rw-r--r--\" + nlink [integer] number of links to file + uid [string] owner + gid [string] group (If the gid is not displayed by ls, + this will still be set (to the same as uid)) + size [integer] file size in bytes + time [string] the time that ls displays, e.g. \"Feb 12 14:17\" + name [string] the name of the file + sym [string] if file is a symbolic link, the linked-to name, else \"\" + +For example, use + + (equal 0 size) + +to mark all zero length files." + ;; Using sym="" instead of nil avoids the trap of + ;; (string-match "foo" sym) into which a user would soon fall. + ;; Give `equal' instead of `=' in the example, as this works on + ;; integers and strings. + (interactive "xMark if (lisp expr): \nP") + (message "%s" predicate) + (let ((dired-marker-char (if unflag-p ?\040 dired-marker-char)) + inode s mode nlink uid gid size time name sym) + (dired-mark-if + (save-excursion + (and + ;; Sets vars + ;; inode s mode nlink uid gid size time name sym + + ;; according to current file line. Returns t for success, nil if + ;; there is no file line. Upon success, all variables are set, either + ;; to nil or the appropriate value, so they need not be initialized. + ;; Moves point within the current line. + (if (dired-move-to-filename) + (let (pos + (mode-len 10) ; length of mode string + ;; like in dired.el, but with subexpressions \1=inode, \2=s: + (dired-re-inode-size "\\s *\\([0-9]*\\)\\s *\\([0-9]*\\) ?")) + (beginning-of-line) + (forward-char 2) + (if (looking-at dired-re-inode-size) + (progn + (goto-char (match-end 0)) + (setq inode (string-to-int (buffer-substring (match-beginning 1) + (match-end 1))) + s (string-to-int (buffer-substring (match-beginning 2) + (match-end 2))))) + (setq inode nil + s nil)) + (setq mode (buffer-substring (point) (+ mode-len (point)))) + (forward-char mode-len) + (setq nlink (read (current-buffer))) + (setq uid (buffer-substring (point) (progn (forward-word 1) (point)))) + (re-search-forward "\\(Jan\\|Feb\\|Mar\\|Apr\\|May\\|Jun\\|Jul\\|Aug\\|Sep\\|Oct\\|Nov\\|Dec\\)") + (goto-char (match-beginning 1)) + (forward-char -1) + (setq size (string-to-int (buffer-substring (save-excursion + (backward-word 1) + (setq pos (point))) + (point)))) + (goto-char pos) + (backward-word 1) + ;; if no gid is displayed, gid will be set to uid + ;; but user will then not reference it anyway in PREDICATE. + (setq gid (buffer-substring (save-excursion (forward-word 1) (point)) + (point)) + time (buffer-substring (match-beginning 1) + (1- (dired-move-to-filename))) + name (buffer-substring (point) + (or (dired-move-to-end-of-filename t) + (point))) + sym (progn + (if (looking-at " -> ") + (buffer-substring (progn (forward-char 4) (point)) + (progn (end-of-line) (point))) + ""))) + t) + nil) + (eval predicate))) + (format "'%s file" predicate)))) + + +;;;; FIND FILE AT POINT. +(defun dired-find-this-file (&optional other-window) + "Edit filename or directory at point. +Switch to a buffer visiting filename, creating one if none already exists. +With non-nil prefix argument OTHER-WINDOW do so in the other window. + +Useful for editing the file mentioned in the buffer you are viewing, or to +test if that file exists. Use minibuffer after snatching the filename." + + (interactive "P") + (let* ((guess (dired-filename-at-point)) + (file (read-file-name "Find file: " guess guess nil nil))) + (if other-window + (find-file-other-window (expand-file-name file)) + (find-file (expand-file-name file))))) + +(fset 'find-this-file 'dired-find-this-file) + +;;; Internal function. +(defun dired-filename-at-point () + + ;; Get the filename closest to point, but do not change position. Has a + ;; preference for looking backward when not directly on a symbol. Not + ;; perfect - point must be in middle of or end of filename. + + (let ((filename-chars ".a-zA-Z0-9---_/:$") + (bol (save-excursion (beginning-of-line) (point))) + (eol (save-excursion (end-of-line) (point))) + start end filename) + + (save-excursion + ;; First see if just past a filename. + (if (not (eobp)) + (if (looking-at "[] \t\n[{}()]") ; whitespace or some parens + (progn + (skip-chars-backward " \n\t\r({[]})") + (if (not (bobp)) + (backward-char 1))))) + + (if (string-match (concat "[" filename-chars "]") + (char-to-string (following-char))) + (progn + (skip-chars-backward filename-chars) + (setq start (point)) + (if (string-match "[/~]" (char-to-string (preceding-char))) + (setq start (1- start))) + (skip-chars-forward filename-chars)) + + (error "No file found around point!")) + + ;; Return string. + (expand-file-name (buffer-substring start (point)))))) + + +;;;; BUG REPORTS + +;;; This section is provided for reports. It uses Barry A. Warsaw's +;;; reporter.el which is bundled with GNU Emacs v19. + +(defconst dired-x-version "2.14" + "Revision number of dired-x.el -- dired extra for GNU Emacs v19. +Type M-x dired-x-submit-report to send a bug report. Available via anonymous +ftp in + + /roebling.poly.edu:/pub/packages/dired-x.tar.gz") + +(defconst dired-x-help-address "dodd@roebling.poly.edu" + "Address(es) accepting submission of reports on dired-x.el.") + +(defconst dired-x-maintainer "Larry" + "First name(s) of people accepting submission of reports on dired-x.el.") + +(defconst dired-x-file "dired-x.el" + "Name of file containing emacs lisp code.") + +(defconst dired-x-variable-list + (list + 'dired-bind-vm + 'dired-vm-read-only-folders + 'dired-bind-jump + 'dired-bind-info + 'dired-bind-man + 'dired-find-subdir + 'dired-enable-local-variables + 'dired-local-variables-file + 'dired-guess-shell-gnutar + 'dired-guess-shell-gzip-quiet + 'dired-guess-shell-znew-switches + 'dired-guess-shell-alist-user + 'dired-clean-up-buffers-too + 'dired-omit-files-p + 'dired-omit-files + 'dired-omit-extensions + ) + "List of variables to be appended to reports sent by `dired-x-submit-report.'") + +(defun dired-x-submit-report () + "Submit via reporter.el a bug report on program. Send report on `dired-x-file' +version `dired-x-version,' to `dired-x-maintainer' at address `dired-x-help-address' +listing variables `dired-x-variable-list' in the message." + (interactive) + + ;; In case we can't find reporter... + (condition-case err + (progn + ;; Get it if we can. + (require 'reporter) + + (reporter-submit-bug-report + dired-x-help-address ; address + (concat dired-x-file " (" dired-x-version ")") ; pkgname + dired-x-variable-list ; varlist + nil nil ; pre-/post-hooks + (concat dired-x-maintainer ","))) ; salutation + + ;; ...fail gracefully. + (error + (beep) + (message "Sorry, reporter.el not found.")))) + + +;; As Barry Warsaw would say: "This might be useful..." +(provide 'dired-x) + +;;; dired-x.el ends here