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