Merge from emacs--rel--22
[bpt/emacs.git] / lisp / emulation / viper-init.el
1 ;;; viper-init.el --- some common definitions for Viper
2
3 ;; Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
5
6 ;; Author: Michael Kifer <kifer@cs.stonybrook.edu>
7
8 ;; This file is part of GNU Emacs.
9
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 3, or (at your option)
13 ;; any later version.
14
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
19
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 ;; Boston, MA 02110-1301, USA.
24
25 ;;; Commentary:
26
27 ;;; Code:
28
29 ;; compiler pacifier
30 (defvar mark-even-if-inactive)
31 (defvar quail-mode)
32 (defvar iso-accents-mode)
33 (defvar viper-current-state)
34 (defvar viper-version)
35 (defvar viper-expert-level)
36 (defvar current-input-method)
37 (defvar default-input-method)
38 (defvar describe-current-input-method-function)
39 (defvar bar-cursor)
40 (defvar default-cursor-type)
41 (defvar cursor-type)
42 ;; end pacifier
43
44
45 ;; Viper version
46 (defun viper-version ()
47 (interactive)
48 (message "Viper version is %s" viper-version))
49
50 ;; Tell whether we are running as a window application or on a TTY
51
52 (defsubst viper-device-type ()
53 (if (featurep 'xemacs)
54 (device-type (selected-device))
55 window-system))
56
57 (defun viper-color-display-p ()
58 (condition-case nil
59 (if (featurep 'xemacs)
60 (eq (device-class (selected-device)) 'color)
61 (display-color-p))
62 (error nil)))
63
64 ;; in XEmacs: device-type is tty on tty and stream in batch.
65 (defun viper-window-display-p ()
66 (and (viper-device-type) (not (memq (viper-device-type) '(tty stream pc)))))
67
68 (defcustom viper-ms-style-os-p (memq system-type
69 '(ms-dos windows-nt windows-95))
70 "Tells if Emacs is running under an MS-style OS: ms-dos, windows-nt, W95."
71 :type 'boolean
72 :tag "Is it Microsoft-made OS?"
73 :group 'viper-misc)
74 (defcustom viper-vms-os-p (memq system-type '(vax-vms axp-vms))
75 "Tells if Emacs is running under VMS."
76 :type 'boolean
77 :tag "Is it VMS?"
78 :group 'viper-misc)
79
80 (defcustom viper-suppress-input-method-change-message nil
81 "If t, the message notifying about changes in the input method is not displayed.
82 Normally, a message is displayed each time on enters the vi, insert or replace
83 state."
84 :type 'boolean
85 :group 'viper-misc)
86
87 (defcustom viper-force-faces nil
88 "If t, Viper will think that it is running on a display that supports faces.
89 This is provided as a temporary relief for users of graphics-capable terminals
90 that Viper doesn't know about.
91 In all likelihood, you don't need to bother with this setting."
92 :type 'boolean
93 :group 'viper-highlighting)
94
95 (defun viper-has-face-support-p ()
96 (cond ((viper-window-display-p))
97 (viper-force-faces)
98 ((viper-color-display-p))
99 ((featurep 'emacs) (memq (viper-device-type) '(pc)))
100 ((featurep 'xemacs) (memq (viper-device-type) '(tty pc)))))
101
102 \f
103 ;;; Macros
104
105 (defmacro viper-deflocalvar (var default-value &optional documentation)
106 `(progn
107 (defvar ,var ,default-value
108 ,(format "%s\n\(buffer local\)" documentation))
109 (make-variable-buffer-local ',var)))
110
111 ;; (viper-loop COUNT BODY) Execute BODY COUNT times.
112 (defmacro viper-loop (count &rest body)
113 `(let ((count ,count))
114 (while (> count 0)
115 ,@body
116 (setq count (1- count)))))
117
118 (defmacro viper-buffer-live-p (buf)
119 `(and ,buf (get-buffer ,buf) (buffer-name (get-buffer ,buf))))
120
121 ;; return buffer-specific macro definition, given a full macro definition
122 (defmacro viper-kbd-buf-alist (macro-elt)
123 `(nth 1 ,macro-elt))
124 ;; get a pair: (curr-buffer . macro-definition)
125 (defmacro viper-kbd-buf-pair (macro-elt)
126 `(assoc (buffer-name) (viper-kbd-buf-alist ,macro-elt)))
127 ;; get macro definition for current buffer
128 (defmacro viper-kbd-buf-definition (macro-elt)
129 `(cdr (viper-kbd-buf-pair ,macro-elt)))
130
131 ;; return mode-specific macro definitions, given a full macro definition
132 (defmacro viper-kbd-mode-alist (macro-elt)
133 `(nth 2 ,macro-elt))
134 ;; get a pair: (major-mode . macro-definition)
135 (defmacro viper-kbd-mode-pair (macro-elt)
136 `(assoc major-mode (viper-kbd-mode-alist ,macro-elt)))
137 ;; get macro definition for the current major mode
138 (defmacro viper-kbd-mode-definition (macro-elt)
139 `(cdr (viper-kbd-mode-pair ,macro-elt)))
140
141 ;; return global macro definition, given a full macro definition
142 (defmacro viper-kbd-global-pair (macro-elt)
143 `(nth 3 ,macro-elt))
144 ;; get global macro definition from an elt of macro-alist
145 (defmacro viper-kbd-global-definition (macro-elt)
146 `(cdr (viper-kbd-global-pair ,macro-elt)))
147
148 ;; last elt of a sequence
149 (defsubst viper-seq-last-elt (seq)
150 (elt seq (1- (length seq))))
151
152 (defsubst viper-string-to-list (string)
153 (append (vconcat string) nil))
154
155 (defsubst viper-charlist-to-string (list)
156 (mapconcat 'char-to-string list ""))
157
158 ;; like char-after/before, but saves typing
159 (defun viper-char-at-pos (direction &optional offset)
160 (or (integerp offset) (setq offset 0))
161 (if (eq direction 'forward)
162 (char-after (+ (point) offset))
163 (char-before (- (point) offset))))
164
165 \f
166 (defvar viper-minibuffer-overlay-priority 300)
167 (defvar viper-replace-overlay-priority 400)
168 (defvar viper-search-overlay-priority 500)
169
170 \f
171 ;;; Viper minor modes
172
173 ;; Mode for vital things like \e, C-z.
174 (viper-deflocalvar viper-vi-intercept-minor-mode nil)
175
176 (viper-deflocalvar viper-vi-basic-minor-mode nil
177 "Viper's minor mode for Vi bindings.")
178
179 (viper-deflocalvar viper-vi-local-user-minor-mode nil
180 "Auxiliary minor mode for user-defined local bindings in Vi state.")
181
182 (viper-deflocalvar viper-vi-global-user-minor-mode nil
183 "Auxiliary minor mode for user-defined global bindings in Vi state.")
184
185 (viper-deflocalvar viper-vi-state-modifier-minor-mode nil
186 "Minor mode used to make major-mode-specific modification to Vi state.")
187
188 (viper-deflocalvar viper-vi-diehard-minor-mode nil
189 "This minor mode is in effect when the user wants Viper to be Vi.")
190
191 (viper-deflocalvar viper-vi-kbd-minor-mode nil
192 "Minor mode for Ex command macros in Vi state.
193 The corresponding keymap stores key bindings of Vi macros defined with
194 the Ex command :map.")
195
196 ;; Mode for vital things like \e, C-z.
197 (viper-deflocalvar viper-insert-intercept-minor-mode nil)
198
199 (viper-deflocalvar viper-insert-basic-minor-mode nil
200 "Viper's minor mode for bindings in Insert mode.")
201
202 (viper-deflocalvar viper-insert-local-user-minor-mode nil
203 "Auxiliary minor mode for buffer-local user-defined bindings in Insert state.
204 This is a way to overshadow normal Insert mode bindings locally to certain
205 designated buffers.")
206
207 (viper-deflocalvar viper-insert-global-user-minor-mode nil
208 "Auxiliary minor mode for global user-defined bindings in Insert state.")
209
210 (viper-deflocalvar viper-insert-state-modifier-minor-mode nil
211 "Minor mode used to make major-mode-specific modification to Insert state.")
212
213 (viper-deflocalvar viper-insert-diehard-minor-mode nil
214 "Minor mode that simulates Vi very closely.
215 Not recommened, except for the novice user.")
216
217 (viper-deflocalvar viper-insert-kbd-minor-mode nil
218 "Minor mode for Ex command macros Insert state.
219 The corresponding keymap stores key bindings of Vi macros defined with
220 the Ex command :map!.")
221
222 (viper-deflocalvar viper-replace-minor-mode nil
223 "Minor mode in effect in replace state (cw, C, and the like commands).")
224
225 ;; Mode for vital things like \C-z and \C-x) This is set to t, when viper-mode
226 ;; is invoked. So, any new buffer will have C-z defined as switch to Vi,
227 ;; unless we switched states in this buffer
228 (viper-deflocalvar viper-emacs-intercept-minor-mode nil)
229
230 (viper-deflocalvar viper-emacs-local-user-minor-mode nil
231 "Minor mode for local user bindings effective in Emacs state.
232 Users can use it to override Emacs bindings when Viper is in its Emacs
233 state.")
234
235 (viper-deflocalvar viper-emacs-global-user-minor-mode nil
236 "Minor mode for global user bindings in effect in Emacs state.
237 Users can use it to override Emacs bindings when Viper is in its Emacs
238 state.")
239
240 (viper-deflocalvar viper-emacs-kbd-minor-mode nil
241 "Minor mode for Vi style macros in Emacs state.
242 The corresponding keymap stores key bindings of Vi macros defined with
243 `viper-record-kbd-macro' command. There is no Ex-level command to do this
244 interactively.")
245
246 (viper-deflocalvar viper-emacs-state-modifier-minor-mode nil
247 "Minor mode used to make major-mode-specific modification to Emacs state.
248 For instance, a Vi purist may want to bind `dd' in Dired mode to a function
249 that deletes a file.")
250
251 (viper-deflocalvar viper-vi-minibuffer-minor-mode nil
252 "Minor mode that forces Vi-style when the Minibuffer is in Vi state.")
253
254 (viper-deflocalvar viper-insert-minibuffer-minor-mode nil
255 "Minor mode that forces Vi-style when the Minibuffer is in Insert state.")
256
257 \f
258
259 ;; Some common error messages
260
261 (defconst viper-SpuriousText "Spurious text after command" "")
262 (defconst viper-BadExCommand "Not an editor command" "")
263 (defconst viper-InvalidCommandArgument "Invalid command argument" "")
264 (defconst viper-NoPrevSearch "No previous search string" "")
265 (defconst viper-EmptyRegister "`%c': Nothing in this register" "")
266 (defconst viper-InvalidRegister "`%c': Invalid register" "")
267 (defconst viper-EmptyTextmarker "`%c': Text marker doesn't point anywhere" "")
268 (defconst viper-InvalidTextmarker "`%c': Invalid text marker" "")
269 (defconst viper-InvalidViCommand "Invalid command" "")
270 (defconst viper-BadAddress "Ill-formed address" "")
271 (defconst viper-FirstAddrExceedsSecond "First address exceeds second" "")
272 (defconst viper-NoFileSpecified "No file specified" "")
273
274 ;; Is t until viper-mode executes for the very first time.
275 ;; Prevents recursive descend into startup messages.
276 (defvar viper-first-time t)
277
278 (defvar viper-expert-level (if (boundp 'viper-expert-level) viper-expert-level 0)
279 "User's expert level.
280 The minor mode viper-vi-diehard-minor-mode is in effect when
281 viper-expert-level is 1 or 2 or when viper-want-emacs-keys-in-vi is t.
282 The minor mode viper-insert-diehard-minor-mode is in effect when
283 viper-expert-level is 1 or 2 or if viper-want-emacs-keys-in-insert is t.
284 Use `M-x viper-set-expert-level' to change this.")
285
286 ;; Max expert level supported by Viper. This is NOT a user option.
287 ;; It is here to make it hard for the user from resetting it.
288 (defconst viper-max-expert-level 5)
289
290
291 ;;; ISO characters and MULE
292
293 ;; If non-nil, ISO accents will be turned on in insert/replace emacs states and
294 ;; turned off in vi-state. For some users, this behavior may be too
295 ;; primitive. In this case, use insert/emacs/vi state hooks.
296 (viper-deflocalvar viper-automatic-iso-accents nil "")
297 ;; Set iso-accents-mode to ARG. Check if it is bound first
298 (defsubst viper-set-iso-accents-mode (arg)
299 (if (boundp 'iso-accents-mode)
300 (setq iso-accents-mode arg)))
301
302 ;; Internal flag used to control when viper mule hooks are run.
303 ;; Don't change this!
304 (defvar viper-mule-hook-flag t)
305 ;; If non-nil, the default intl. input method is turned on.
306 (viper-deflocalvar viper-special-input-method nil "")
307
308 ;; viper hook to run on input-method activation
309 (defun viper-activate-input-method-action ()
310 (if (null viper-mule-hook-flag)
311 ()
312 (setq viper-special-input-method t)
313 ;; turn off special input methods in vi-state
314 (if (eq viper-current-state 'vi-state)
315 (viper-set-input-method nil))
316 (if (and (memq viper-current-state '(vi-state insert-state replace-state))
317 (not viper-suppress-input-method-change-message))
318 (message "Viper special input method%s: on"
319 (if (or current-input-method default-input-method)
320 (format " %S"
321 (or current-input-method default-input-method))
322 "")))
323 ))
324
325 ;; viper hook to run on input-method deactivation
326 (defun viper-inactivate-input-method-action ()
327 (if (null viper-mule-hook-flag)
328 ()
329 (setq viper-special-input-method nil)
330 (if (and (memq viper-current-state '(vi-state insert-state replace-state))
331 (not viper-suppress-input-method-change-message))
332 (message "Viper special input method%s: off"
333 (if (or current-input-method default-input-method)
334 (format " %S"
335 (or current-input-method default-input-method))
336 "")))))
337
338 (defun viper-inactivate-input-method ()
339 (cond ((and (featurep 'emacs) (fboundp 'inactivate-input-method))
340 (inactivate-input-method))
341 ((and (featurep 'xemacs) (boundp 'current-input-method))
342 ;; XEmacs had broken quail-mode for some time, so we are working around
343 ;; it here
344 (setq quail-mode nil)
345 (if (featurep 'quail)
346 (quail-delete-overlays))
347 (setq describe-current-input-method-function nil)
348 (setq current-input-method nil)
349 (run-hooks 'input-method-inactivate-hook)
350 (force-mode-line-update))
351 ))
352 (defun viper-activate-input-method ()
353 (cond ((and (featurep 'emacs) (fboundp 'activate-input-method))
354 (activate-input-method default-input-method))
355 ((featurep 'xemacs)
356 (if (fboundp 'quail-mode) (quail-mode 1)))))
357
358 ;; Set quail-mode to ARG
359 (defun viper-set-input-method (arg)
360 (setq viper-mule-hook-flag t) ; just a precaution
361 (let (viper-mule-hook-flag) ; temporarily deactivate viper mule hooks
362 (cond ((and arg (> (prefix-numeric-value arg) 0) default-input-method)
363 ;; activate input method
364 (viper-activate-input-method))
365 (t ; deactivate input method
366 (viper-inactivate-input-method)))
367 ))
368
369
370 ;; VI-style Undo
371
372 ;; Used to 'undo' complex commands, such as replace and insert commands.
373 (viper-deflocalvar viper-undo-needs-adjustment nil)
374 (put 'viper-undo-needs-adjustment 'permanent-local t)
375
376 ;; A mark that Viper puts on buffer-undo-list. Marks the beginning of a
377 ;; complex command that must be undone atomically. If inserted, it is
378 ;; erased by viper-change-state-to-vi and viper-repeat.
379 (defconst viper-buffer-undo-list-mark 'viper)
380
381 (defcustom viper-keep-point-on-undo nil
382 "*Non-nil means not to move point while undoing commands.
383 This style is different from Emacs and Vi. Try it to see if
384 it better fits your working style."
385 :type 'boolean
386 :tag "Preserve Position of Point After Undo"
387 :group 'viper)
388
389 ;; Replace mode and changing text
390
391 ;; Hack used to pass global states around for short period of time
392 (viper-deflocalvar viper-intermediate-command nil "")
393
394 ;; This is used to pass the right Vi command key sequence to
395 ;; viper-set-destructive-command whenever (this-command-keys) doesn't give the
396 ;; right result. For instance, in commands like c/bla<RET>,
397 ;; (this-command-keys) will return ^M, which invoked exit-minibuffer, while we
398 ;; need "c/"
399 (defconst viper-this-command-keys nil)
400
401 ;; Indicates that the current destructive command has started in replace mode.
402 (viper-deflocalvar viper-began-as-replace nil "")
403
404 (defcustom viper-allow-multiline-replace-regions t
405 "If non-nil, Viper will allow multi-line replace regions.
406 This is an extension to standard Vi.
407 If nil, commands that attempt to replace text spanning multiple lines first
408 delete the text being replaced, as in standard Vi."
409 :type 'boolean
410 :group 'viper)
411
412 (defcustom viper-replace-overlay-cursor-color "Red"
413 "*Cursor color when Viper is in Replace state."
414 :type 'string
415 :group 'viper)
416
417 (defcustom viper-insert-state-cursor-color "Green"
418 "Cursor color when Viper is in insert state."
419 :type 'string
420 :group 'viper)
421
422 ;; viper-emacs-state-cursor-color doesn't work well. Causes cursor colors to be
423 ;; confused in some cases. So, this var is nulled for now.
424 ;; (defcustom viper-emacs-state-cursor-color "Magenta"
425 (defcustom viper-emacs-state-cursor-color nil
426 "Cursor color when Viper is in Emacs state."
427 :type 'string
428 :group 'viper)
429
430 ;; internal var, used to remember the default cursor color of emacs frames
431 (defvar viper-vi-state-cursor-color nil)
432
433 ;; Frame-local variables are obsolete from Emacs 22.2 onwards, so we
434 ;; do it by hand with viper-frame-value (qv).
435 (when (and (featurep 'xemacs)
436 (fboundp 'make-variable-frame-local))
437 (make-variable-frame-local 'viper-replace-overlay-cursor-color)
438 (make-variable-frame-local 'viper-insert-state-cursor-color)
439 (make-variable-frame-local 'viper-emacs-state-cursor-color)
440 (make-variable-frame-local 'viper-vi-state-cursor-color))
441
442 (viper-deflocalvar viper-replace-overlay nil "")
443 (put 'viper-replace-overlay 'permanent-local t)
444
445 (defcustom viper-replace-region-end-delimiter "$"
446 "A string marking the end of replacement regions.
447 It is used only with TTYs or if `viper-use-replace-region-delimiters'
448 is non-nil."
449 :type 'string
450 :group 'viper)
451 (defcustom viper-replace-region-start-delimiter ""
452 "A string marking the beginning of replacement regions.
453 It is used only with TTYs or if `viper-use-replace-region-delimiters'
454 is non-nil."
455 :type 'string
456 :group 'viper)
457 (defcustom viper-use-replace-region-delimiters
458 (or (not (viper-has-face-support-p))
459 (and (featurep 'xemacs) (eq (viper-device-type) 'tty)))
460 "*If non-nil, Viper will always use `viper-replace-region-end-delimiter' and
461 `viper-replace-region-start-delimiter' to delimit replacement regions, even on
462 color displays. By default, the delimiters are used only on TTYs."
463 :type 'boolean
464 :group 'viper)
465
466 (defcustom viper-read-buffer-function 'read-buffer
467 "Function to use for prompting the user for a buffer name."
468 :type 'symbol
469 :group 'viper)
470
471 ;; XEmacs requires glyphs
472 (when (featurep 'xemacs)
473 (or (glyphp viper-replace-region-end-delimiter)
474 (setq viper-replace-region-end-delimiter
475 (make-glyph viper-replace-region-end-delimiter)))
476 (or (glyphp viper-replace-region-start-delimiter)
477 (setq viper-replace-region-start-delimiter
478 (make-glyph viper-replace-region-start-delimiter))))
479
480 ;; These are local marker that must be initialized to nil and moved with
481 ;; `viper-move-marker-locally'
482 ;;
483 ;; Remember the last position inside the replace region.
484 (viper-deflocalvar viper-last-posn-in-replace-region nil)
485 ;; Remember the last position while inserting
486 (viper-deflocalvar viper-last-posn-while-in-insert-state nil)
487 (put 'viper-last-posn-in-replace-region 'permanent-local t)
488 (put 'viper-last-posn-while-in-insert-state 'permanent-local t)
489
490 (viper-deflocalvar viper-sitting-in-replace nil "")
491 (put 'viper-sitting-in-replace 'permanent-local t)
492
493 ;; Remember the number of characters that have to be deleted in replace
494 ;; mode to compensate for the inserted characters.
495 (viper-deflocalvar viper-replace-chars-to-delete 0 "")
496 ;; This variable is used internally by the before/after changed functions to
497 ;; determine how many chars were deleted by the change. This can't be
498 ;; determined inside after-change-functions because those get the length of the
499 ;; deleted region, not the number of chars deleted (which are two different
500 ;; things under MULE).
501 (viper-deflocalvar viper-replace-region-chars-deleted 0 "")
502
503 ;; Insertion ring and command ring
504 (defcustom viper-insertion-ring-size 14
505 "The size of history of inserted text.
506 This is a list where Viper keeps the history of previously inserted pieces of
507 text."
508 :type 'integer
509 :group 'viper-misc)
510 ;; The insertion ring.
511 (defvar viper-insertion-ring nil)
512 ;; This is temp insertion ring. Used to do rotation for display purposes.
513 ;; When rotation just started, it is initialized to viper-insertion-ring.
514 (defvar viper-temp-insertion-ring nil)
515 (defvar viper-last-inserted-string-from-insertion-ring "")
516
517 (defcustom viper-command-ring-size 14
518 "The size of history of Vi commands repeatable with dot."
519 :type 'integer
520 :group 'viper-misc)
521 ;; The command ring.
522 (defvar viper-command-ring nil)
523 ;; This is temp command ring. Used to do rotation for display purposes.
524 ;; When rotation just started, it is initialized to viper-command-ring.
525 (defvar viper-temp-command-ring nil)
526
527 ;; Fast keyseq and ESC keyseq timeouts
528 (defcustom viper-fast-keyseq-timeout 200
529 "*Key sequence separated by no more than this many milliseconds is viewed as a Vi-style macro, if such a macro is defined.
530 Setting this too high may slow down your typing. Setting this value too low
531 will make it hard to use Vi-style timeout macros."
532 :type 'integer
533 :group 'viper-misc)
534
535 (defcustom viper-ESC-keyseq-timeout (if (viper-window-display-p)
536 0 viper-fast-keyseq-timeout)
537 "*Key sequence beginning with ESC and separated by no more than this many milliseconds is considered to be generated by a keyboard function key.
538 Setting this too high may slow down switching from insert to vi state. Setting
539 this value too low will make it impossible to use function keys in insert mode
540 on a dumb terminal."
541 :type 'integer
542 :group 'viper-misc)
543
544 (defcustom viper-translate-all-ESC-keysequences (not (viper-window-display-p))
545 "Allow translation of all key sequences into commands.
546 Normally, Viper lets Emacs translate only those ESC key sequences that are
547 defined in the low-level key-translation-map or function-key-map, such as those
548 emitted by the arrow and function keys. Other sequences, e.g., \\e/, are
549 treated as ESC command followed by a `/'. This is done for people who type fast
550 and tend to hit other characters right after they hit ESC. Other people like
551 Emacs to translate ESC sequences all the time.
552 The default is to translate all sequences only when using a dumb terminal.
553 This permits you to use ESC as a meta key in insert mode."
554 :type 'boolean
555 :group 'viper-misc)
556
557 ;; Modes and related variables
558
559 ;; Current mode. One of: `emacs-state', `vi-state', `insert-state'
560 (viper-deflocalvar viper-current-state 'emacs-state)
561
562
563 ;; Autoindent in insert
564
565 ;; Variable that keeps track of whether C-t has been pressed.
566 (viper-deflocalvar viper-cted nil "")
567
568 ;; Preserve the indent value, used by C-d in insert mode.
569 (viper-deflocalvar viper-current-indent 0)
570
571 ;; Whether to preserve the indent, used by C-d in insert mode.
572 (viper-deflocalvar viper-preserve-indent nil)
573
574 (viper-deflocalvar viper-auto-indent nil "")
575 (defcustom viper-auto-indent nil
576 "*Enable autoindent, if t.
577 This is a buffer-local variable."
578 :type 'boolean
579 :group 'viper)
580
581 (viper-deflocalvar viper-electric-mode t "")
582 (defcustom viper-electric-mode t
583 "*If t, electrify Viper.
584 Currently, this only electrifies auto-indentation, making it appropriate to the
585 mode of the buffer.
586 This means that auto-indentation will depart from standard Vi and will indent
587 appropriate to the mode of the buffer. This is especially useful for editing
588 programs and LaTeX documents."
589 :type 'boolean
590 :group 'viper)
591
592 (defcustom viper-shift-width 8
593 "*The value of the shiftwidth.
594 This determines the number of columns by which the Ctl-t moves the cursor in
595 the Insert state."
596 :type 'integer
597 :group 'viper)
598
599 ;; Variables for repeating destructive commands
600
601 (defcustom viper-keep-point-on-repeat t
602 "*If t, don't move point when repeating previous command.
603 This is useful for doing repeated changes with the '.' key.
604 The user can change this to nil, if she likes when the cursor moves
605 to a new place after repeating previous Vi command."
606 :type 'boolean
607 :group 'viper)
608
609 ;; Remember insert point as a marker. This is a local marker that must be
610 ;; initialized to nil and moved with `viper-move-marker-locally'.
611 (viper-deflocalvar viper-insert-point nil)
612 (put 'viper-insert-point 'permanent-local t)
613
614 ;; This remembers the point before dabbrev-expand was called.
615 ;; If viper-insert-point turns out to be bigger than that, it is reset
616 ;; back to viper-pre-command-point.
617 ;; The reason this is needed is because dabbrev-expand (and possibly
618 ;; others) may jump to before the insertion point, delete something and
619 ;; then reinsert a bigger piece. For instance: bla^blo
620 ;; If dabbrev-expand is called after `blo' and ^ undicates viper-insert-point,
621 ;; then point jumps to the beginning of `blo'. If expansion is found, `blablo'
622 ;; is deleted, and we have |^, where | denotes point. Next, dabbrev-expand
623 ;; will insert the expansion, and we get: blablo^
624 ;; Whatever we insert next goes before the ^, i.e., before the
625 ;; viper-insert-point marker. So, Viper will think that nothing was
626 ;; inserted. Remembering the orig position of the marker circumvents the
627 ;; problem.
628 ;; We don't know of any command, except dabbrev-expand, that has the same
629 ;; problem. However, the same trick can be used if such a command is
630 ;; discovered later.
631 ;;
632 (viper-deflocalvar viper-pre-command-point nil)
633 (put 'viper-pre-command-point 'permanent-local t) ; this is probably an overkill
634
635 ;; This is used for saving inserted text.
636 (defvar viper-last-insertion nil)
637
638 ;; Remembers the last replaced region.
639 (defvar viper-last-replace-region "")
640
641 ;; Remember com point as a marker.
642 ;; This is a local marker. Should be moved with `viper-move-marker-locally'
643 (viper-deflocalvar viper-com-point nil)
644
645 ;; If non-nil, the value is a list (M-COM VAL COM REG inserted-text cmd-keys)
646 ;; It is used to re-execute last destructive command.
647 ;; M-COM is a Lisp symbol representing the function to be executed.
648 ;; VAL is the prefix argument that was used with that command.
649 ;; COM is an internal descriptor, such as ?r, ?c, ?C, which contains
650 ;; additional information on how the function in M-COM is to be handled.
651 ;; REG is the register used by command
652 ;; INSERTED-TEXT is text inserted by that command (in case of o, c, C, i, r
653 ;; commands).
654 ;; COMMAND-KEYS are the keys that were typed to invoke the command.
655 (defvar viper-d-com nil)
656
657 ;; The character remembered by the Vi `r' command.
658 (defvar viper-d-char nil)
659
660 ;; Name of register to store deleted or yanked strings
661 (defvar viper-use-register nil)
662
663
664 ;;; Variables for Moves and Searches
665
666 (defgroup viper-search nil
667 "Variables that define the search and query-replace behavior of Viper."
668 :prefix "viper-"
669 :group 'viper)
670
671 ;; For use by `;' command.
672 (defvar viper-f-char nil)
673
674 ;; For use by `.' command.
675 (defvar viper-F-char nil)
676
677 ;; For use by `;' command.
678 (defvar viper-f-forward nil)
679
680 ;; For use by `;' command.
681 (defvar viper-f-offset nil)
682
683 ;; Last search string
684 (defvar viper-s-string "")
685
686 (defcustom viper-quote-string "> "
687 "String inserted at the beginning of quoted region."
688 :type 'string
689 :group 'viper)
690
691 ;; If t, search is forward.
692 (defvar viper-s-forward nil)
693
694 (defcustom viper-case-fold-search nil
695 "*If not nil, search ignores cases."
696 :type 'boolean
697 :group 'viper-search)
698
699 (defcustom viper-re-search t
700 "*If not nil, search is regexp search, otherwise vanilla search."
701 :type 'boolean
702 :tag "Regexp Search"
703 :group 'viper-search)
704
705 (defcustom viper-search-scroll-threshold 2
706 "*If search lands within this threshnold from the window top/bottom,
707 the window will be scrolled up or down appropriately, to reveal context.
708 If you want Viper search to behave as usual in Vi, set this variable to a
709 negative number."
710 :type 'boolean
711 :group 'viper-search)
712
713 (defcustom viper-re-query-replace t
714 "*If t then do regexp replace, if nil then do string replace."
715 :type 'boolean
716 :tag "Regexp Query Replace"
717 :group 'viper-search)
718
719 (defcustom viper-re-replace t
720 "*If t, do regexp replace. nil means do string replace."
721 :type 'boolean
722 :tag "Regexp Replace"
723 :group 'viper-search)
724
725 (defcustom viper-parse-sexp-ignore-comments t
726 "*If t, `%' ignores the parentheses that occur inside comments."
727 :type 'boolean
728 :group 'viper)
729
730 (viper-deflocalvar viper-ex-style-motion t "")
731 (defcustom viper-ex-style-motion t
732 "*If t, the commands l,h do not cross lines, etc (Ex-style).
733 If nil, these commands cross line boundaries."
734 :type 'boolean
735 :group 'viper)
736
737 (viper-deflocalvar viper-ex-style-editing t "")
738 (defcustom viper-ex-style-editing t
739 "*If t, Ex-style behavior while editing in Vi command and insert states.
740 `Backspace' and `Delete' don't cross line boundaries in insert.
741 `X' and `x' can't delete characters across line boundary in Vi, etc.
742 Note: this doesn't preclude `Backspace' and `Delete' from deleting characters
743 by moving past the insertion point. This is a feature, not a bug.
744
745 If nil, the above commands can work across lines."
746 :type 'boolean
747 :group 'viper)
748
749 (viper-deflocalvar viper-ESC-moves-cursor-back viper-ex-style-editing "")
750 (defcustom viper-ESC-moves-cursor-back nil
751 "*If t, ESC moves cursor back when changing from insert to vi state.
752 If nil, the cursor stays where it was when ESC was hit."
753 :type 'boolean
754 :group 'viper)
755
756 (viper-deflocalvar viper-delete-backwards-in-replace nil "")
757 (defcustom viper-delete-backwards-in-replace nil
758 "*If t, DEL key will delete characters while moving the cursor backwards.
759 If nil, the cursor will move backwards without deleting anything."
760 :type 'boolean
761 :group 'viper)
762
763 (defcustom viper-buffer-search-char nil
764 "*Key used for buffer-searching. Must be a character type, e.g., ?g."
765 :type '(choice (const nil) character)
766 :group 'viper-search)
767
768 (defcustom viper-search-wrap-around-t t
769 "*If t, search wraps around."
770 :type 'boolean
771 :tag "Search Wraps Around"
772 :group 'viper-search)
773
774 (viper-deflocalvar viper-related-files-and-buffers-ring nil "")
775 (defcustom viper-related-files-and-buffers-ring nil
776 "*List of file and buffer names that are considered to be related to the current buffer.
777 Related buffers can be cycled through via :R and :P commands."
778 :type 'boolean
779 :group 'viper-misc)
780 (put 'viper-related-files-and-buffers-ring 'permanent-local t)
781
782 ;; Used to find out if we are done with searching the current buffer.
783 (viper-deflocalvar viper-local-search-start-marker nil)
784 ;; As above, but global
785 (defvar viper-search-start-marker (make-marker))
786
787 ;; the search overlay
788 (viper-deflocalvar viper-search-overlay nil)
789
790
791 (defvar viper-heading-start
792 (concat "^\\s-*(\\s-*defun\\s-\\|" ; lisp
793 "^{\\s-*$\\|^[_a-zA-Z][^()]*[()].*{\\s-*$\\|" ; C/C++
794 "^\\s-*class.*{\\|^\\s-*struct.*{\\|^\\s-*enum.*{\\|"
795 "^\\\\[sb][a-z]*{.*}\\s-*$\\|" ; latex
796 "^@node\\|@table\\|^@m?enu\\|^@itemize\\|^@if\\|" ; texinfo
797 "^.+:-") ; prolog
798 "*Regexps for Headings. Used by \[\[ and \]\].")
799
800 (defvar viper-heading-end
801 (concat "^}\\|" ; C/C++
802 "^\\\\end{\\|" ; latex
803 "^@end \\|" ; texinfo
804 ")\n\n[ \t\n]*\\|" ; lisp
805 "\\.\\s-*$") ; prolog
806 "*Regexps to end Headings/Sections. Used by \[\].")
807
808
809 ;; These two vars control the interaction of jumps performed by ' and `.
810 ;; In this new version, '' doesn't erase the marks set by ``, so one can
811 ;; use both kinds of jumps interchangeably and without loosing positions
812 ;; inside the lines.
813
814 ;; Remembers position of the last jump done using ``'.
815 (viper-deflocalvar viper-last-jump nil)
816 ;; Remembers position of the last jump done using `''.
817 (viper-deflocalvar viper-last-jump-ignore 0)
818
819 ;; History variables
820
821 ;; History of search strings.
822 (defvar viper-search-history (list ""))
823 ;; History of query-replace strings used as a source.
824 (defvar viper-replace1-history nil)
825 ;; History of query-replace strings used as replacement.
826 (defvar viper-replace2-history nil)
827 ;; History of region quoting strings.
828 (defvar viper-quote-region-history (list viper-quote-string))
829 ;; History of Ex-style commands.
830 (defvar viper-ex-history nil)
831 ;; History of shell commands.
832 (defvar viper-shell-history nil)
833
834
835 ;; Last shell command. There are two of these, one for Ex (in viper-ex)
836 ;; and one for Vi.
837
838 ;; Last shell command executed with ! command.
839 (defvar viper-last-shell-com nil)
840
841 \f
842 ;;; Face-saving tricks
843
844 (defgroup viper-highlighting nil
845 "Hilighting of replace region, search pattern, minibuffer, etc."
846 :prefix "viper-"
847 :group 'viper)
848
849
850 (defface viper-search
851 '((((class color)) (:foreground "Black" :background "khaki"))
852 (t (:underline t :stipple "gray3")))
853 "*Face used to flash out the search pattern."
854 :group 'viper-highlighting)
855 ;; An internal variable. Viper takes the face from here.
856 (defvar viper-search-face 'viper-search
857 "Face used to flash out the search pattern.
858 DO NOT CHANGE this variable. Instead, use the customization widget
859 to customize the actual face object `viper-search'
860 this variable represents.")
861
862 (defface viper-replace-overlay
863 '((((class color)) (:foreground "Black" :background "darkseagreen2"))
864 (t (:underline t :stipple "gray3")))
865 "*Face for highlighting replace regions on a window display."
866 :group 'viper-highlighting)
867 ;; An internal variable. Viper takes the face from here.
868 (defvar viper-replace-overlay-face 'viper-replace-overlay
869 "Face for highlighting replace regions on a window display.
870 DO NOT CHANGE this variable. Instead, use the customization widget
871 to customize the actual face object `viper-replace-overlay'
872 this variable represents.")
873
874 (defface viper-minibuffer-emacs
875 '((((class color)) (:foreground "Black" :background "darkseagreen2"))
876 (t (:weight bold)))
877 "Face used in the Minibuffer when it is in Emacs state."
878 :group 'viper-highlighting)
879 ;; An internal variable. Viper takes the face from here.
880 (defvar viper-minibuffer-emacs-face 'viper-minibuffer-emacs
881 "Face used in the Minibuffer when it is in Emacs state.
882 DO NOT CHANGE this variable. Instead, use the customization widget
883 to customize the actual face object `viper-minibuffer-emacs'
884 this variable represents.")
885
886 (defface viper-minibuffer-insert
887 '((((class color)) (:foreground "Black" :background "pink"))
888 (t (:slant italic)))
889 "Face used in the Minibuffer when it is in Insert state."
890 :group 'viper-highlighting)
891 ;; An internal variable. Viper takes the face from here.
892 (defvar viper-minibuffer-insert-face 'viper-minibuffer-insert
893 "Face used in the Minibuffer when it is in Insert state.
894 DO NOT CHANGE this variable. Instead, use the customization widget
895 to customize the actual face object `viper-minibuffer-insert'
896 this variable represents.")
897
898 (defface viper-minibuffer-vi
899 '((((class color)) (:foreground "DarkGreen" :background "grey"))
900 (t (:inverse-video t)))
901 "Face used in the Minibuffer when it is in Vi state."
902 :group 'viper-highlighting)
903 ;; An internal variable. Viper takes the face from here.
904 (defvar viper-minibuffer-vi-face 'viper-minibuffer-vi
905 "Face used in the Minibuffer when it is in Vi state.
906 DO NOT CHANGE this variable. Instead, use the customization widget
907 to customize the actual face object `viper-minibuffer-vi'
908 this variable represents.")
909
910 ;; the current face to be used in the minibuffer
911 (viper-deflocalvar
912 viper-minibuffer-current-face viper-minibuffer-emacs-face "")
913
914 \f
915 ;;; Miscellaneous
916
917 (defvar viper-inhibit-startup-message nil
918 "Whether Viper startup message should be inhibited.")
919
920 (defcustom viper-spell-function 'ispell-region
921 "Spell function used by #s<move> command to spell."
922 :type 'function
923 :group 'viper-misc)
924
925 (defcustom viper-tags-file-name "TAGS"
926 "The tags file used by Viper."
927 :type 'string
928 :group 'viper-misc)
929
930 (defcustom viper-change-notification-threshold 1
931 "Notify the user when this many lines or characters have been deleted/yanked.
932 For line-deleting/yanking commands (like `dd', `yy'), the value denotes the
933 number of lines. For character-based commands (such as `x', `dw', etc.), the
934 value refers to the number of characters affected."
935 :type 'integer
936 :group 'viper-misc)
937
938 ;; Minibuffer
939
940 (defcustom viper-vi-style-in-minibuffer t
941 "If t, use vi-style editing in minibuffer.
942 Should be set in `~/.viper' file."
943 :type 'boolean
944 :group 'viper)
945
946 ;; overlay used in the minibuffer to indicate which state it is in
947 (viper-deflocalvar viper-minibuffer-overlay nil)
948 (put 'viper-minibuffer-overlay 'permanent-local t)
949
950 ;; Hook, specific to Viper, which is run just *before* exiting the minibuffer.
951 ;; This is needed because beginning with Emacs 19.26, the standard
952 ;; `minibuffer-exit-hook' is run *after* exiting the minibuffer
953 (defvar viper-minibuffer-exit-hook nil)
954
955
956 ;; Mode line
957 (defconst viper-vi-state-id "<V> "
958 "Mode line tag identifying the Vi mode of Viper.")
959 (defconst viper-emacs-state-id "<E> "
960 "Mode line tag identifying the Emacs mode of Viper.")
961 (defconst viper-insert-state-id "<I> "
962 "Mode line tag identifying the Insert mode of Viper.")
963 (defconst viper-replace-state-id "<R> "
964 "Mode line tag identifying the Replace mode of Viper.")
965
966
967 (defgroup viper-hooks nil
968 "Viper hooks."
969 :prefix "viper-"
970 :group 'viper)
971
972 (defcustom viper-vi-state-hook 'viper-restore-cursor-type
973 "*Hooks run just before the switch to Vi mode is completed."
974 :type 'hook
975 :group 'viper-hooks)
976 (defcustom viper-insert-state-hook 'viper-set-insert-cursor-type
977 "*Hooks run just before the switch to Insert mode is completed."
978 :type 'hook
979 :group 'viper-hooks)
980 (defcustom viper-replace-state-hook 'viper-restore-cursor-type
981 "*Hooks run just before the switch to Replace mode is completed."
982 :type 'hook
983 :group 'viper-hooks)
984 (defcustom viper-emacs-state-hook 'viper-restore-cursor-type
985 "*Hooks run just before the switch to Emacs mode is completed."
986 :type 'hook
987 :group 'viper-hooks)
988
989 (defcustom viper-load-hook nil
990 "Hooks run just after loading Viper."
991 :type 'hook
992 :group 'viper-hooks)
993
994 (defun viper-restore-cursor-type ()
995 (condition-case nil
996 (if (featurep 'xemacs)
997 (set (make-local-variable 'bar-cursor) nil)
998 (setq cursor-type default-cursor-type))
999 (error nil)))
1000
1001 (defun viper-set-insert-cursor-type ()
1002 (if (featurep 'xemacs)
1003 (set (make-local-variable 'bar-cursor) 2)
1004 (setq cursor-type '(bar . 2))))
1005
1006
1007 (provide 'viper-init)
1008
1009
1010 ;; Local Variables:
1011 ;; eval: (put 'viper-deflocalvar 'lisp-indent-hook 'defun)
1012 ;; End:
1013
1014 ;; arch-tag: 4efa2416-1fcb-4690-be10-1a2a0248d250
1015 ;;; viper-init.el ends here