1 ;;; em-rebind.el --- rebind keys when point is at current input
3 ;; Copyright (C) 1999, 2000 Free Software Foundation
5 ;; Author: John Wiegley <johnw@gnu.org>
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
26 (eval-when-compile (require 'esh-maint
))
28 (defgroup eshell-rebind nil
29 "This module allows for special keybindings that only take effect
30 while the point is in a region of input text. By default, it binds
31 C-a to move to the beginning of the input text (rather than just the
32 beginning of the line), and C-p and C-n to move through the input
33 history, C-u kills the current input text, etc. It also, if
34 `eshell-confine-point-to-input' is non-nil, does not allow certain
35 commands to cause the point to leave the input area, such as
36 `backward-word', `previous-line', etc. This module intends to mimic
37 the behavior of normal shells while the user editing new input text."
38 :tag
"Rebind keys at input"
39 :group
'eshell-module
)
45 (defcustom eshell-rebind-load-hook
'(eshell-rebind-initialize)
46 "*A list of functions to call when loading `eshell-rebind'."
48 :group
'eshell-rebind
)
50 (defcustom eshell-rebind-keys-alist
51 '(([(control ?a
)] . eshell-bol
)
53 ([(control ?d)] . eshell-delchar-or-maybe-eof)
54 ([backspace] . eshell-delete-backward-char)
55 ([delete] . eshell-delete-backward-char)
56 ([(control ?w)] . backward-kill-word)
57 ([(control ?u)] . eshell-kill-input))
58 "*Bind some keys differently if point is in input text."
59 :type '(repeat (cons (vector :tag "Keys to bind"
60 (repeat :inline t sexp))
61 (function :tag "Command")))
62 :group 'eshell-rebind)
64 (defcustom eshell-confine-point-to-input t
65 "*If non-nil, do not allow the point to leave the current input.
66 This is more difficult to do nicely in Emacs than one might think.
67 Basically, the `point-left' attribute is added to the input text, and
68 a function is placed on that hook to take the point back to
69 `eshell-last-output-end' every time the user tries to move away. But
70 since there are many cases in which the point _ought_ to move away
71 \(for programmatic reasons), the variable
72 `eshell-cannot-leave-input-list' defines commands which are affected
73 from this rule. However, this list is by no means as complete as it
74 probably should be, so basically all one can hope for is that other
75 people will left the point alone in the Eshell buffer. Sigh."
77 :group 'eshell-rebind)
79 (defcustom eshell-error-if-move-away t
80 "*If non-nil, consider it an error to try to move outside current input.
81 This is default behavior of shells like bash."
83 :group 'eshell-rebind)
85 (defcustom eshell-remap-previous-input t
86 "*If non-nil, remap input keybindings on previous prompts as well."
88 :group 'eshell-rebind)
90 (defcustom eshell-cannot-leave-input-list
91 '(beginning-of-line-text
102 backward-delete-char-untabify
104 backward-kill-paragraph
106 backward-kill-sentence
119 backward-prefix-chars
124 forward-to-indentation
125 backward-to-indentation
135 "*A list of commands that cannot leave the input area."
136 :type '(repeat function)
137 :group 'eshell-rebind)
139 ;; Internal Variables:
141 (defvar eshell-input-keymap)
142 (defvar eshell-previous-point)
143 (defvar eshell-lock-keymap)
147 (defun eshell-rebind-initialize ()
148 "Initialize the inputing code."
149 (unless eshell-non-interactive-p
150 (make-local-hook 'eshell-mode-hook)
151 (add-hook 'eshell-mode-hook 'eshell-setup-input-keymap nil t)
152 (make-local-hook 'pre-command-hook)
153 (make-local-variable 'eshell-previous-point)
154 (add-hook 'pre-command-hook 'eshell-save-previous-point nil t)
155 (make-local-hook 'post-command-hook)
156 (make-local-variable 'overriding-local-map)
157 (add-hook 'post-command-hook 'eshell-rebind-input-map nil t)
158 (set (make-local-variable 'eshell-lock-keymap) nil)
159 (define-key eshell-command-map [(meta ?l)] 'eshell-lock-local-map)))
161 (defun eshell-lock-local-map (&optional arg)
162 "Lock or unlock the current local keymap.
163 Within a prefix arg, set the local keymap to its normal value, and
166 (if (or arg (not eshell-lock-keymap))
168 (use-local-map eshell-mode-map)
169 (setq eshell-lock-keymap t)
170 (message "Local keymap locked in normal mode"))
171 (use-local-map eshell-input-keymap)
172 (setq eshell-lock-keymap nil)
173 (message "Local keymap unlocked: obey context")))
175 (defun eshell-save-previous-point ()
176 "Save the location of point before the next command is run."
177 (setq eshell-previous-point (point)))
179 (defsubst eshell-point-within-input-p (pos)
180 "Test whether POS is within an input range."
182 (or (and (>= pos eshell-last-output-end)
183 eshell-last-output-end)
184 (and eshell-remap-previous-input
188 (and (not (bolp)) (point))))
190 (<= pos (line-end-position))
193 (defun eshell-rebind-input-map ()
194 "Rebind the input keymap based on the location of the cursor."
196 (unless eshell-lock-keymap
197 (if (eshell-point-within-input-p (point))
198 (use-local-map eshell-input-keymap)
200 (if (and eshell-confine-point-to-input
202 (eshell-point-within-input-p eshell-previous-point))
203 (memq this-command eshell-cannot-leave-input-list))
205 (use-local-map eshell-input-keymap)
207 (if (and eshell-error-if-move-away
208 (not (eq this-command 'kill-region)))
210 (use-local-map eshell-mode-map)))))))
212 (defun eshell-setup-input-keymap ()
213 "Setup the input keymap to be used during input editing."
214 (make-local-variable 'eshell-input-keymap)
215 (setq eshell-input-keymap (make-sparse-keymap))
216 (set-keymap-parent eshell-input-keymap eshell-mode-map)
217 (let ((bindings eshell-rebind-keys-alist))
219 (define-key eshell-input-keymap (caar bindings)
221 (setq bindings (cdr bindings)))))
223 (defun eshell-delete-backward-char (n &optional killflag)
224 "Delete the last character, unless it's part of the output."
226 (let ((count (prefix-numeric-value n)))
227 (if (eshell-point-within-input-p (- (point) count))
228 (delete-backward-char count n)
231 (defun eshell-delchar-or-maybe-eof (arg)
232 "Delete ARG characters forward or send an EOF to subprocess.
233 Sends an EOF only if point is at the end of the buffer and there is no
236 (let ((proc (eshell-interactive-process)))
239 ((/= (point) eshell-last-output-end)
244 (eshell-life-is-too-much)))
245 (eshell-delete-backward-char (- arg)))))
249 ;;; em-rebind.el ends here