annotate lisp/shell.el @ 638:40b255f55df3

*** empty log message ***
author Jim Blandy <jimb@redhat.com>
date Sun, 10 May 1992 18:15:10 +0000
parents 1ef0a9b58e63
children 7cbd4fcd8b0f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
1 ;;; -*-Emacs-Lisp-*- General command interpreter in a window stuff
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
2 ;;; Copyright Olin Shivers (1988).
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
3 ;;; Please imagine a long, tedious, legalistic 5-page gnu-style copyright
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
4 ;;; notice appearing here to the effect that you may use this code any
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
5 ;;; way you like, as long as you don't charge money for it, remove this
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
6 ;;; notice, or hold me liable for its results.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
7
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
8 ;;; The changelog is at the end of file.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
9
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
10 ;;; Please send me bug reports, bug fixes, and extensions, so that I can
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
11 ;;; merge them into the master source.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
12 ;;; - Olin Shivers (shivers@cs.cmu.edu)
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
13
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
14 ;;; This file defines a a shell-in-a-buffer package (shell mode) built
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
15 ;;; on top of comint mode. This shell mode is similar to its
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
16 ;;; counterpart in the GNU Emacs 18 release, but is more featureful,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
17 ;;; robust, and uniform than that version.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
18
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
19 ;;; Since this mode is built on top of the general command-interpreter-in-
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
20 ;;; a-buffer mode (comint mode), it shares a common base functionality,
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
21 ;;; and a common set of bindings, with all modes derived from comint mode.
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
22 ;;; This makes these modes easier to use.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
23
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
24 ;;; For documentation on the functionality provided by comint mode, and
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
25 ;;; the hooks available for customising it, see the file comint.el.
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
26 ;;; For further information on shell mode, see the comments below.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
27
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
28 ;;; Needs fixin:
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
29 ;;; When sending text from a source file to a subprocess, the process-mark can
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
30 ;;; move off the window, so you can lose sight of the process interactions.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
31 ;;; Maybe I should ensure the process mark is in the window when I send
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
32 ;;; text to the process? Switch selectable?
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
33
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
34 (require 'comint)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
35 (provide 'shell)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
36
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
37 ;; YOUR .EMACS FILE
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
38 ;;=============================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
39 ;; Some suggestions for your .emacs file.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
40 ;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
41 ;; ; If shell lives in some non-standard directory, you must tell emacs
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
42 ;; ; where to get it. This may or may not be necessary.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
43 ;; (setq load-path (cons (expand-file-name "~jones/lib/emacs") load-path))
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
44 ;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
45 ;; ; Autoload shell from file shell.el
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
46 ;; (autoload 'shell "shell"
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
47 ;; "Run an inferior shell process."
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
48 ;; t)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
49 ;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
50 ;; ; Define C-c t to run my favorite command in shell mode:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
51 ;; (setq shell-load-hook
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
52 ;; '((lambda ()
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
53 ;; (define-key shell-mode-map "\C-ct" 'favorite-cmd))))
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
54
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
55
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
56 ;;; Brief Command Documentation:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
57 ;;;============================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
58 ;;; Comint Mode Commands: (common to shell and all comint-derived modes)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
59 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
60 ;;; m-p comint-previous-input Cycle backwards in input history
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
61 ;;; m-n comint-next-input Cycle forwards
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
62 ;;; m-c-r comint-previous-input-matching Search backwards in input history
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
63 ;;; return comint-send-input
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
64 ;;; c-a comint-bol Beginning of line; skip prompt.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
65 ;;; c-d comint-delchar-or-maybe-eof Delete char unless at end of buff.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
66 ;;; c-c c-u comint-kill-input ^u
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
67 ;;; c-c c-w backward-kill-word ^w
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
68 ;;; c-c c-c comint-interrupt-subjob ^c
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
69 ;;; c-c c-z comint-stop-subjob ^z
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
70 ;;; c-c c-\ comint-quit-subjob ^\
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
71 ;;; c-c c-o comint-kill-output Delete last batch of process output
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
72 ;;; c-c c-r comint-show-output Show last batch of process output
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
73 ;;; send-invisible Read line w/o echo & send to proc
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
74 ;;; comint-continue-subjob Useful if you accidentally suspend
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
75 ;;; top-level job.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
76 ;;; comint-mode-hook is the comint mode hook.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
77
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
78 ;;; Shell Mode Commands:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
79 ;;; shell Fires up the shell process.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
80 ;;; tab comint-dynamic-complete Complete a partial file name
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
81 ;;; m-? comint-dynamic-list-completions List completions in help buffer
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
82 ;;; dirs Resync the buffer's dir stack.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
83 ;;; dirtrack-toggle Turn dir tracking on/off.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
84 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
85 ;;; The shell mode hook is shell-mode-hook
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
86 ;;; The shell-load-hook is run after this file is loaded.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
87 ;;; comint-prompt-regexp is initialised to shell-prompt-pattern, for backwards
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
88 ;;; compatibility.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
89
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
90 ;;; Read the rest of this file for more information.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
91
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
92 ;;; Emacs 18 SHELL.EL COMPATIBILITY
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
93 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
94 ;;; The below notes were written before this shell package became the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
95 ;;; official shell mode of the standard Emacs distribution, and talk
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
96 ;;; about getting this package to work well with the old shell package
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
97 ;;; and its users. This issue isn't quite as relevant now as it was
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
98 ;;; then, but the notes below should still be useful for people
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
99 ;;; modifying elisp packages that used the old shell mode to use this
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
100 ;;; one. Note that some of the variables referred to have lost their
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
101 ;;; `cmu-' prefix.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
102 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
103 ;;;============================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
104 ;;; In brief: this package should have no trouble coexisting with shell.el.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
105 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
106 ;;; Most customising variables -- e.g., explicit-shell-file-name -- are the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
107 ;;; same, so the users shouldn't have much trouble. Hooks have different
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
108 ;;; names, however, so you can customise shell mode differently from shell
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
109 ;;; mode. You basically just have to remember to type M-x cmushell instead of
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
110 ;;; M-x shell.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
111 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
112 ;;; It would be nice if this file was completely plug-compatible with the old
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
113 ;;; shell package -- if you could just name this file shell.el, and have it
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
114 ;;; transparently replace the old one. But you can't. Several other packages
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
115 ;;; (tex-mode, background, dbx, gdb, kermit, monkey, prolog, telnet) are also
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
116 ;;; clients of shell mode. These packages assume detailed knowledge of shell
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
117 ;;; mode internals in ways that are incompatible with cmushell mode (mostly
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
118 ;;; because of cmushell mode's greater functionality). So, unless we are
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
119 ;;; willing to port all of these packages, we can't have this file be a
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
120 ;;; complete replacement for shell.el -- that is, we can't name this file
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
121 ;;; shell.el, and its main entry point (shell), because dbx.el will break
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
122 ;;; when it loads it in and tries to use it.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
123 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
124 ;;; There are two ways to fix this. One: rewrite these other modes to use the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
125 ;;; new package. This is a win, but can't be assumed. The other, backwards
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
126 ;;; compatible route, is to make this package non-conflict with shell.el, so
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
127 ;;; both files can be loaded in at the same time. And *that* is why some
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
128 ;;; functions and variables have different names: (cmushell),
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
129 ;;; cmushell-mode-map, that sort of thing. All the names have been carefully
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
130 ;;; chosen so that shell.el and cmushell.el won't tromp on each other.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
131
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
132 ;;; Customisation and Buffer Variables
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
133 ;;; ===========================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
134 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
135
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
136 ;In loaddefs.el now.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
137 ;(defconst shell-prompt-pattern
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
138 ; "^[^#$%>]*[#$%>] *"
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
139 ; "*Regexp used by Newline command to match subshell prompts.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
140 ;;; Change the doc string for shell-prompt-pattern:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
141 (put 'shell-prompt-pattern 'variable-documentation
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
142 "Regexp to match prompts in the inferior shell.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
143 Defaults to \"^[^#$%>]*[#$%>] *\", which works pretty well.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
144 This variable is used to initialise comint-prompt-regexp in the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
145 shell buffer.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
146
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
147 This is a fine thing to set in your .emacs file.")
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
148
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
149 (defvar shell-popd-regexp "popd"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
150 "*Regexp to match subshell commands equivalent to popd.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
151
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
152 (defvar shell-pushd-regexp "pushd"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
153 "*Regexp to match subshell commands equivalent to pushd.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
154
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
155 (defvar shell-cd-regexp "cd"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
156 "*Regexp to match subshell commands equivalent to cd.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
157
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
158 (defvar explicit-shell-file-name nil
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
159 "*If non-nil, is file name to use for explicitly requested inferior shell.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
160
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
161 (defvar explicit-csh-args
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
162 (if (eq system-type 'hpux)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
163 ;; -T persuades HP's csh not to think it is smarter
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
164 ;; than us about what terminal modes to use.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
165 '("-i" "-T")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
166 '("-i"))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
167 "*Args passed to inferior shell by M-x shell, if the shell is csh.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
168 Value is a list of strings, which may be nil.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
169
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
170 ;;; All the above vars aren't prefixed "shell-" to make them
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
171 ;;; backwards compatible w/shell.el and old .emacs files.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
172
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
173 (defvar shell-dirstack nil
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
174 "List of directories saved by pushd in this buffer's shell.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
175
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
176 (defvar shell-dirstack-query "dirs"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
177 "Command used by shell-resync-dirlist to query shell.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
178
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
179 (defvar shell-mode-map '())
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
180 (cond ((not shell-mode-map)
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
181 (setq shell-mode-map (full-copy-sparse-keymap comint-mode-map))
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
182 (define-key shell-mode-map "\t" 'comint-dynamic-complete)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
183 (define-key shell-mode-map "\M-?" 'comint-dynamic-list-completions)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
184
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
185 (defvar shell-mode-hook '()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
186 "*Hook for customising shell mode")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
187
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
188
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
189 ;;; Basic Procedures
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
190 ;;; ===========================================================================
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
191 ;;;
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
192
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
193 (defun shell-mode ()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
194 "Major mode for interacting with an inferior shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
195 Return after the end of the process' output sends the text from the
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
196 end of process to the end of the current line.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
197 Return before end of process output copies rest of line to end (skipping
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
198 the prompt) and sends it.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
199 M-x send-invisible reads a line of text without echoing it, and sends it to
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
200 the shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
201
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
202 If you accidentally suspend your process, use \\[comint-continue-subjob]
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
203 to continue it.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
204
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
205 cd, pushd and popd commands given to the shell are watched by Emacs to keep
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
206 this buffer's default directory the same as the shell's working directory.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
207 M-x dirs queries the shell and resyncs Emacs' idea of what the current
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
208 directory stack is.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
209 M-x dirtrack-toggle turns directory tracking on and off.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
210
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
211 \\{shell-mode-map}
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
212 Customisation: Entry to this mode runs the hooks on comint-mode-hook and
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
213 shell-mode-hook (in that order).
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
214
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
215 Variables shell-cd-regexp, shell-pushd-regexp and shell-popd-regexp are used
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
216 to match their respective commands."
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
217 (interactive)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
218 (comint-mode)
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
219 (setq comint-prompt-regexp shell-prompt-pattern)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
220 (setq major-mode 'shell-mode)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
221 (setq mode-name "shell")
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
222 (use-local-map shell-mode-map)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
223 (make-local-variable 'shell-dirstack)
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
224 (setq shell-dirstack nil)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
225 (make-local-variable 'shell-dirtrackp)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
226 (setq shell-dirtrackp t)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
227 (setq comint-input-sentinel 'shell-directory-tracker)
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
228 (run-hooks 'shell-mode-hook))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
229
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
230
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
231 (defun shell ()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
232 "Run an inferior shell, with I/O through buffer *shell*.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
233 If buffer exists but shell process is not running, make new shell.
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
234 If buffer exists and shell process is running,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
235 just switch to buffer *shell*.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
236 Program used comes from variable explicit-shell-file-name,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
237 or (if that is nil) from the ESHELL environment variable,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
238 or else from SHELL if there is no ESHELL.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
239 If a file ~/.emacs_SHELLNAME exists, it is given as initial input
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
240 (Note that this may lose due to a timing error if the shell
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
241 discards input when it starts up.)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
242 The buffer is put in shell-mode, giving commands for sending input
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
243 and controlling the subjobs of the shell. See shell-mode.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
244 See also variable shell-prompt-pattern.
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
245
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
246 The shell file name (sans directories) is used to make a symbol name
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
247 such as `explicit-csh-arguments'. If that symbol is a variable,
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
248 its value is used as a list of arguments when invoking the shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
249 Otherwise, one argument `-i' is passed to the shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
250
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
251 \(Type \\[describe-mode] in the shell buffer for a list of commands.)"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
252 (interactive)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
253 (cond ((not (comint-check-proc "*shell*"))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
254 (let* ((prog (or explicit-shell-file-name
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
255 (getenv "ESHELL")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
256 (getenv "SHELL")
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
257 "/bin/sh"))
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
258 (name (file-name-nondirectory prog))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
259 (startfile (concat "~/.emacs_" name))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
260 (xargs-name (intern-soft (concat "explicit-" name "-args"))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
261 (set-buffer (apply 'make-comint "shell" prog
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
262 (if (file-exists-p startfile) startfile)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
263 (if (and xargs-name (boundp xargs-name))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
264 (symbol-value xargs-name)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
265 '("-i"))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
266 (shell-mode))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
267 (switch-to-buffer "*shell*"))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
268
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
269
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
270 ;;; Directory tracking
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
271 ;;; ===========================================================================
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
272 ;;; This code provides the shell mode input sentinel
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
273 ;;; SHELL-DIRECTORY-TRACKER
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
274 ;;; that tracks cd, pushd, and popd commands issued to the shell, and
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
275 ;;; changes the current directory of the shell buffer accordingly.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
276 ;;;
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
277 ;;; This is basically a fragile hack, although it's more accurate than
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
278 ;;; the released version in shell.el. It has the following failings:
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
279 ;;; 1. It doesn't know about the cdpath shell variable.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
280 ;;; 2. It only spots the first command in a command sequence. E.g., it will
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
281 ;;; miss the cd in "ls; cd foo"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
282 ;;; 3. More generally, any complex command (like ";" sequencing) is going to
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
283 ;;; throw it. Otherwise, you'd have to build an entire shell interpreter in
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
284 ;;; emacs lisp. Failing that, there's no way to catch shell commands where
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
285 ;;; cd's are buried inside conditional expressions, aliases, and so forth.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
286 ;;;
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
287 ;;; The whole approach is a crock. Shell aliases mess it up. File sourcing
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
288 ;;; messes it up. You run other processes under the shell; these each have
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
289 ;;; separate working directories, and some have commands for manipulating
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
290 ;;; their w.d.'s (e.g., the lcd command in ftp). Some of these programs have
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
291 ;;; commands that do *not* affect the current w.d. at all, but look like they
114
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
292 ;;; do (e.g., the cd command in ftp). In shells that allow you job
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
293 ;;; control, you can switch between jobs, all having different w.d.'s. So
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
294 ;;; simply saying %3 can shift your w.d..
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
295 ;;;
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
296 ;;; The solution is to relax, not stress out about it, and settle for
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
297 ;;; a hack that works pretty well in typical circumstances. Remember
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
298 ;;; that a half-assed solution is more in keeping with the spirit of Unix,
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
299 ;;; anyway. Blech.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
300 ;;;
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
301 ;;; One good hack not implemented here for users of programmable shells
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
302 ;;; is to program up the shell w.d. manipulation commands to output
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
303 ;;; a coded command sequence to the tty. Something like
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
304 ;;; ESC | <cwd> |
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
305 ;;; where <cwd> is the new current working directory. Then trash the
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
306 ;;; directory tracking machinery currently used in this package, and
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
307 ;;; replace it with a process filter that watches for and strips out
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
308 ;;; these messages.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
309
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
310 ;;; REGEXP is a regular expression. STR is a string. START is a fixnum.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
311 ;;; Returns T if REGEXP matches STR where the match is anchored to start
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
312 ;;; at position START in STR. Sort of like LOOKING-AT for strings.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
313 (defun shell-front-match (regexp str start)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
314 (eq start (string-match regexp str start)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
315
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
316 (defun shell-directory-tracker (str)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
317 "Tracks cd, pushd and popd commands issued to the shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
318 This function is called on each input passed to the shell.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
319 It watches for cd, pushd and popd commands and sets the buffer's
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
320 default directory to track these commands.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
321
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
322 You may toggle this tracking on and off with M-x dirtrack-toggle.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
323 If emacs gets confused, you can resync with the shell with M-x dirs.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
324
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
325 See variables shell-cd-regexp, shell-pushd-regexp, and shell-popd-regexp.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
326 Environment variables are expanded, see function substitute-in-file-name."
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
327 (condition-case err
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
328 (cond (shell-dirtrackp
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
329 (string-match "^\\s *" str) ; skip whitespace
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
330 (let ((bos (match-end 0))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
331 (x nil))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
332 (cond ((setq x (shell-match-cmd-w/optional-arg shell-popd-regexp
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
333 str bos))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
334 (shell-process-popd (substitute-in-file-name x)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
335 ((setq x (shell-match-cmd-w/optional-arg shell-pushd-regexp
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
336 str bos))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
337 (shell-process-pushd (substitute-in-file-name x)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
338 ((setq x (shell-match-cmd-w/optional-arg shell-cd-regexp
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
339 str bos))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
340 (shell-process-cd (substitute-in-file-name x)))))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
341 (error (message (car (cdr err))))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
342
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
343
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
344 ;;; Try to match regexp CMD to string, anchored at position START.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
345 ;;; CMD may be followed by a single argument. If a match, then return
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
346 ;;; the argument, if there is one, or the empty string if not. If
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
347 ;;; no match, return nil.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
348
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
349 (defun shell-match-cmd-w/optional-arg (cmd str start)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
350 (and (shell-front-match cmd str start)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
351 (let ((eoc (match-end 0))) ; end of command
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
352 (cond ((shell-front-match "\\s *\\(\;\\|$\\)" str eoc)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
353 "") ; no arg
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
354 ((shell-front-match "\\s +\\([^ \t\;]+\\)\\s *\\(\;\\|$\\)"
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
355 str eoc)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
356 (substring str (match-beginning 1) (match-end 1))) ; arg
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
357 (t nil))))) ; something else.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
358 ;;; The first regexp is [optional whitespace, (";" or the end of string)].
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
359 ;;; The second regexp is [whitespace, (an arg), optional whitespace,
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
360 ;;; (";" or end of string)].
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
361
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
362
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
363 ;;; popd [+n]
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
364 (defun shell-process-popd (arg)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
365 (let ((num (if (zerop (length arg)) 0 ; no arg means +0
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
366 (shell-extract-num arg))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
367 (if (and num (< num (length shell-dirstack)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
368 (if (= num 0) ; condition-case because the CD could lose.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
369 (condition-case nil (progn (cd (car shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
370 (setq shell-dirstack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
371 (cdr shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
372 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
373 (error (message "Couldn't cd.")))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
374 (let* ((ds (cons nil shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
375 (cell (nthcdr (- num 1) ds)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
376 (rplacd cell (cdr (cdr cell)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
377 (setq shell-dirstack (cdr ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
378 (shell-dirstack-message)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
379 (message "Bad popd."))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
380
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
381
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
382 ;;; cd [dir]
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
383 (defun shell-process-cd (arg)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
384 (condition-case nil (progn (cd (if (zerop (length arg)) (getenv "HOME")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
385 arg))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
386 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
387 (error (message "Couldn't cd."))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
388
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
389
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
390 ;;; pushd [+n | dir]
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
391 (defun shell-process-pushd (arg)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
392 (if (zerop (length arg))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
393 ;; no arg -- swap pwd and car of shell stack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
394 (condition-case nil (if shell-dirstack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
395 (let ((old default-directory))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
396 (cd (car shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
397 (setq shell-dirstack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
398 (cons old (cdr shell-dirstack)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
399 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
400 (message "Directory stack empty."))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
401 (message "Couldn't cd."))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
402
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
403 (let ((num (shell-extract-num arg)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
404 (if num ; pushd +n
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
405 (if (> num (length shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
406 (message "Directory stack not that deep.")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
407 (let* ((ds (cons default-directory shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
408 (dslen (length ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
409 (front (nthcdr num ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
410 (back (reverse (nthcdr (- dslen num) (reverse ds))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
411 (new-ds (append front back)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
412 (condition-case nil
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
413 (progn (cd (car new-ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
414 (setq shell-dirstack (cdr new-ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
415 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
416 (error (message "Couldn't cd.")))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
417
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
418 ;; pushd <dir>
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
419 (let ((old-wd default-directory))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
420 (condition-case nil
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
421 (progn (cd arg)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
422 (setq shell-dirstack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
423 (cons old-wd shell-dirstack))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
424 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
425 (error (message "Couldn't cd."))))))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
426
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
427 ;; If STR is of the form +n, for n>0, return n. Otherwise, nil.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
428 (defun shell-extract-num (str)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
429 (and (string-match "^\\+[1-9][0-9]*$" str)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
430 (string-to-int str)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
431
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
432
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
433 (defun shell-dirtrack-toggle ()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
434 "Turn directory tracking on and off in a shell buffer."
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
435 (interactive)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
436 (setq shell-dirtrackp (not shell-dirtrackp))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
437 (message "directory tracking %s."
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
438 (if shell-dirtrackp "ON" "OFF")))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
439
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
440 ;;; For your typing convenience:
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
441 (fset 'dirtrack-toggle 'shell-dirtrack-toggle)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
442
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
443
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
444 (defun shell-resync-dirs ()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
445 "Resync the buffer's idea of the current directory stack.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
446 This command queries the shell with the command bound to
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
447 shell-dirstack-query (default \"dirs\"), reads the next
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
448 line output and parses it to form the new directory stack.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
449 DON'T issue this command unless the buffer is at a shell prompt.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
450 Also, note that if some other subprocess decides to do output
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
451 immediately after the query, its output will be taken as the
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
452 new directory stack -- you lose. If this happens, just do the
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
453 command again."
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
454 (interactive)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
455 (let* ((proc (get-buffer-process (current-buffer)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
456 (pmark (process-mark proc)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
457 (goto-char pmark)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
458 (insert shell-dirstack-query) (insert "\n")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
459 (sit-for 0) ; force redisplay
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
460 (comint-send-string proc shell-dirstack-query)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
461 (comint-send-string proc "\n")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
462 (set-marker pmark (point))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
463 (let ((pt (point))) ; wait for 1 line
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
464 ;; This extra newline prevents the user's pending input from spoofing us.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
465 (insert "\n") (backward-char 1)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
466 (while (not (looking-at ".+\n"))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
467 (accept-process-output proc)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
468 (goto-char pt)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
469 (goto-char pmark) (delete-char 1) ; remove the extra newline
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
470 ;; That's the dirlist. grab it & parse it.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
471 (let* ((dl (buffer-substring (match-beginning 0) (- (match-end 0) 1)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
472 (dl-len (length dl))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
473 (ds '()) ; new dir stack
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
474 (i 0))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
475 (while (< i dl-len)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
476 ;; regexp = optional whitespace, (non-whitespace), optional whitespace
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
477 (string-match "\\s *\\(\\S +\\)\\s *" dl i) ; pick off next dir
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
478 (setq ds (cons (substring dl (match-beginning 1) (match-end 1))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
479 ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
480 (setq i (match-end 0)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
481 (let ((ds (reverse ds)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
482 (condition-case nil
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
483 (progn (cd (car ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
484 (setq shell-dirstack (cdr ds))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
485 (shell-dirstack-message))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
486 (error (message "Couldn't cd.")))))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
487
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
488 ;;; For your typing convenience:
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
489 (fset 'dirs 'shell-resync-dirs)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
490
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
491
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
492 ;;; Show the current dirstack on the message line.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
493 ;;; Pretty up dirs a bit by changing "/usr/jqr/foo" to "~/foo".
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
494 ;;; (This isn't necessary if the dirlisting is generated with a simple "dirs".)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
495 ;;; All the commands that mung the buffer's dirstack finish by calling
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
496 ;;; this guy.
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
497 (defun shell-dirstack-message ()
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
498 (let ((msg "")
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
499 (ds (cons default-directory shell-dirstack)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
500 (while ds
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
501 (let ((dir (car ds)))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
502 (if (string-match (format "^%s\\(/\\|$\\)" (getenv "HOME")) dir)
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
503 (setq dir (concat "~/" (substring dir (match-end 0)))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
504 (if (string-equal dir "~/") (setq dir "~"))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
505 (setq msg (concat msg dir " "))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
506 (setq ds (cdr ds))))
899728e6052a Initial revision
David Lawrence <tale@gnu.org>
parents:
diff changeset
507 (message msg)))
252
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
508
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
509
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
510
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
511 ;;; Interfacing to client packages (and converting them)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
512 ;;;============================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
513 ;;; Several gnu packages (tex-mode, background, dbx, gdb, kermit, prolog,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
514 ;;; telnet are some) use the shell package as clients. Most of them would
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
515 ;;; be better off using the comint package directly, but they predate it.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
516 ;;; The catch is that most of these packages (dbx, gdb, prolog, telnet)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
517 ;;; assume total knowledge of all the local variables that shell mode
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
518 ;;; functions depend on. So they (kill-all-local-variables), then create
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
519 ;;; the few local variables that shell.el functions depend on. Alas,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
520 ;;; cmushell.el functions depend on a different set of vars (for example,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
521 ;;; the input history ring is a local variable in cmushell.el's shell mode,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
522 ;;; whereas there is no input history ring in shell.el's shell mode).
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
523 ;;; So we have a situation where the greater functionality of cmushell.el
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
524 ;;; is biting us -- you can't just replace shell will cmushell.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
525 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
526 ;;; Altering these packages to use comint mode directly should *greatly*
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
527 ;;; improve their functionality, and is actually pretty easy. It's
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
528 ;;; mostly a matter of renaming a few variable names. See comint.el for more.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
529 ;;; -Olin
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
530
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
531
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
532
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
533 ;;; Do the user's customisation...
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
534 ;;;===============================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
535 (defvar shell-load-hook nil
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
536 "This hook is run when shell is loaded in.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
537 This is a good place to put keybindings.")
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
538
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
539 (run-hooks 'shell-load-hook)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
540
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
541 ;;; Change Log
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
542 ;;; ===========================================================================
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
543 ;;; Olin 8/88
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
544 ;;; Created.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
545 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
546 ;;; Olin 5/26/90
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
547 ;;; - Split cmulisp and cmushell modes into separate files.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
548 ;;; Not only is this a good idea, it's apparently the way it'll be rel 19.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
549 ;;; - Souped up the directory tracking; it now can handle pushd, pushd +n,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
550 ;;; and popd +n.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
551 ;;; - Added cmushell-dirtrack-toggle command to toggle the directory
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
552 ;;; tracking that cmushell tries to do. This is useful, for example,
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
553 ;;; when you are running ftp -- it prevents the ftp "cd" command from
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
554 ;;; spoofing the tracking machinery. This command is also named
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
555 ;;; dirtrack-toggle, so you need only type M-x dirtrack to run it.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
556 ;;; - Added cmushell-resync-dirs command. This queries the shell
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
557 ;;; for the current directory stack, and resets the buffer's stack
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
558 ;;; accordingly. This command is also named dirs, so you need only type
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
559 ;;; M-x dirs to run it.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
560 ;;; - Bits of the new directory tracking code were adapted from source
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
561 ;;; contributed by Vince Broman, Jeff Peck, and Barry Warsaw.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
562 ;;; - See also the improvements made to comint.el at the same time.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
563 ;;; - Renamed several variables. Mostly this comprised changing "shell"
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
564 ;;; to "cmushell" in the names. The only variables that are not prefixed
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
565 ;;; with "cmushell-" are the ones that are common with shell.el:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
566 ;;; explicit-shell-file-name shell-prompt-pattern explicit-csh-args
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
567 ;;; and shell-cd/popd/pushd-regexp
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
568 ;;; The variables and functions that were changed to have "cmushell-"
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
569 ;;; prefixes are:
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
570 ;;; shell-directory-stack (v), shell-directory-tracker (f)
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
571 ;;; This should not affect users, only elisp hackers. Hopefully
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
572 ;;; one day shell.el will just go away, and we can drop all this
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
573 ;;; "cmushell" bullshit.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
574 ;;; - Upgraded process sends to use comint-send-string instead of
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
575 ;;; process-send-string.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
576 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
577 ;;; Olin 6/14/90
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
578 ;;; - If your shell is named <shellname>, and a variable named
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
579 ;;; explicit-<shellname>-args exists, cmushell is supposed
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
580 ;;; to use its value as the arglist to the shell invocation.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
581 ;;; E.g., if you define explicit-csh-args to be
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
582 ;;; ("-ifx"), then when cmushell cranks up a csh, it execs it
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
583 ;;; as "csh -ifx". This is what is documented. What has actually
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
584 ;;; been the case is that the variable checked is
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
585 ;;; explicit-<shellname>-arguments, not explicit-<shellname>-args.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
586 ;;; The documentation has been changed to conform to the code (for
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
587 ;;; backwards compatibility with shell.el). This bug is inherited from
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
588 ;;; the same bug in shell.el.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
589 ;;; This bug reported by Stephen Anderson.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
590 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
591 ;;; Olin 9/5/90
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
592 ;;; - Arguments to cd, popd, and pushd now have their env vars expanded
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
593 ;;; out by the tracking machinery. So if you say "cd $SRCDIR/funs", the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
594 ;;; $SRCDIR var will be replaced by its value *in emacs' process
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
595 ;;; environment*. If this is different from the shell's binding of the
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
596 ;;; variable, you lose. Several users needed this feature, fragile
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
597 ;;; though it may be. The fix was contributed by sk@thp.Uni-Koeln.DE.
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
598 ;;;
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
599 ;;; Olin 3/12/91
1ef0a9b58e63 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 114
diff changeset
600 ;;; - Moved comint-dynamic-complete (filename completion) from M-tab to tab.