Fix last change of grow_mini_window.
[bpt/emacs.git] / lisp / emulation / viper.el
CommitLineData
8831bbed 1;;; viper.el --- A full-featured Vi emulator for Emacs and XEmacs,
6c2e12f4
KH
2;; a VI Plan for Emacs Rescue,
3;; and a venomous VI PERil.
4;; Viper Is also a Package for Emacs Rebels.
6c2e12f4 5
ab422c4d 6;; Copyright (C) 1994-2013 Free Software Foundation, Inc.
151496c0 7
50a07e18 8;; Author: Michael Kifer <kifer@cs.stonybrook.edu>
02f34c70 9;; Keywords: emulations
aad4679e 10;; Version: 3.14.1
02f34c70 11
241760a3
SM
12;; Yoni Rabkin <yoni@rabkins.net> contacted the maintainer of this
13;; file on 20/3/2008, and the maintainer agreed that when a bug is
14;; filed in the Emacs bug reporting system against this file, a copy
15;; of the bug report be sent to the maintainer's email address.
16
f1e6674b 17(defconst viper-version "3.14.2 of July 4, 2013"
03fc1246
MK
18 "The current version of Viper")
19
6c2e12f4
KH
20;; This file is part of GNU Emacs.
21
ed0f493f 22;; GNU Emacs is free software: you can redistribute it and/or modify
6c2e12f4 23;; it under the terms of the GNU General Public License as published by
ed0f493f
GM
24;; the Free Software Foundation, either version 3 of the License, or
25;; (at your option) any later version.
6c2e12f4
KH
26
27;; GNU Emacs is distributed in the hope that it will be useful,
28;; but WITHOUT ANY WARRANTY; without even the implied warranty of
29;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
30;; GNU General Public License for more details.
31
32;; You should have received a copy of the GNU General Public License
ed0f493f 33;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
6c2e12f4
KH
34
35;;; Commentary:
36
3af0304a 37;; Viper is a full-featured Vi emulator for Emacs and XEmacs. It emulates and
6c2e12f4
KH
38;; improves upon the standard features of Vi and, at the same time, allows
39;; full access to all Emacs facilities. Viper supports multiple undo,
40;; file name completion, command, file, and search history and it extends
3af0304a 41;; Vi in many other ways. Viper is highly customizable through the various
6c2e12f4
KH
42;; hooks, user variables, and keymaps. It is implemented as a collection
43;; of minor modes and it is designed to provide full access to all Emacs
44;; major and minor modes.
45;;
3afbc435 46;;; History:
6c2e12f4
KH
47;;
48;; Viper is a new name for a package formerly known as VIP-19,
49;; which was a successor of VIP version 3.5 by Masahiko Sato
50;; <ms@sail.stanford.edu> and VIP version 4.2 by Aamod Sane
3af0304a 51;; <sane@cs.uiuc.edu>. Some ideas from vip 4.4.2 by Aamod Sane
6c2e12f4
KH
52;; were also shamelessly plagiarized.
53;;
54;; Viper maintains some degree of compatibility with these older
3af0304a 55;; packages. See the documentation for customization.
6c2e12f4
KH
56;;
57;; The main difference between Viper and these older packages are:
58;;
59;; 1. Viper emulates Vi at several levels, from almost complete conformity
60;; to a rather loose Vi-compliance.
61;;
62;; 2. Viper provides full access to all major and minor modes of Emacs
63;; without the need to type extra keys.
64;; The older versions of VIP (and other Vi emulators) do not work with
65;; some major and minor modes.
66;;
67;; 3. Viper supports vi-style undo.
68;;
69;; 4. Viper fully emulates (and improves upon) vi's replacement mode.
70;;
71;; 5. Viper has a better interface to ex, including command, variable, and
72;; file name completion.
73;;
74;; 6. Viper uses native Emacs history and completion features; it doesn't
75;; rely on other packages (such as gmhist.el and completer.el) to provide
76;; these features.
77;;
78;; 7. Viper supports Vi-style editing in the minibuffer, by allowing the
79;; user to switch from Insert state to Vi state to Replace state, etc.
80;;
81;; 8. Viper keeps history of recently inserted pieces of text and recently
82;; executed Vi-style destructive commands, such as `i', `d', etc.
83;; These pieces of text can be inserted in later insertion commands;
84;; the previous destructive commands can be re-executed.
85;;
86;; 9. Viper has Vi-style keyboard macros, which enhances the similar
87;; facility in the original Vi.
88;; First, one can execute any Emacs command while defining a
3af0304a 89;; macro, not just the Vi commands. Second, macros are defined in a
44e97401 90;; WYSYWYG mode, using an interface to Emacs's WYSIWYG style of defining
3af0304a 91;; macros. Third, in Viper, one can define macros that are specific to
6c2e12f4
KH
92;; a given buffer, a given major mode, or macros defined for all buffers.
93;; The same macro name can have several different definitions:
94;; one global, several definitions for various major modes, and
95;; definitions for specific buffers.
d63a37ea 96;; Buffer-specific definitions override mode-specific
6c2e12f4
KH
97;; definitions, which, in turn, override global definitions.
98;;
99;;
100;;; Installation:
101;; -------------
102;;
103;; (require 'viper)
104;;
105
09ae5da1
PE
106;;; Acknowledgments:
107;; ----------------
d63a37ea
KH
108;; Bug reports and ideas contributed by many users have helped
109;; improve Viper and the various versions of VIP.
a1506d29 110;; See the on-line manual for a complete list of contributors.
6c2e12f4
KH
111;;
112;;
113;;; Notes:
114;;
115;; 1. Major modes.
116;; In most cases, Viper handles major modes correctly, i.e., they come up
3af0304a 117;; in the right state (either vi-state or emacs-state). For instance, text
6c2e12f4 118;; files come up in vi-state, while, say, Dired appears in emacs-state by
a1506d29 119;; default.
6c2e12f4
KH
120;; However, some modes do not appear in the right mode in the beginning,
121;; usually because they neglect to follow Emacs conventions (e.g., they don't
3af0304a 122;; use kill-all-local-variables when they start). Some major modes
6c2e12f4 123;; may fail to come up in emacs-state if they call hooks, such as
a1506d29
JB
124;; text-hook, for no good reason.
125;;
6c2e12f4
KH
126;; As an immediate solution, you can hit C-z to bring about the right mode.
127;; An interim solution is to add an appropriate hook to the mode like this:
a1506d29 128;;
6c2e12f4 129;; (add-hook 'your-favorite-mode 'viper-mode)
a1506d29 130;; or
8626cfa2 131;; (add-hook 'your-favorite-mode 'viper-change-state-to-emacs)
a1506d29 132;;
3af0304a 133;; whichever applies. The right thing to do, however, is to complain to the
6c2e12f4
KH
134;; author of the respective package. (Sometimes they also neglect to equip
135;; their modes with hooks, which is one more reason for complaining.)
a1506d29 136;;
6c2e12f4 137;; 2. Keymap handling
8626cfa2
MK
138;; Each Viper state (insert, vi, replace) is implemented as a collection of
139;; several minor modes, each with its own keymap.
6c2e12f4
KH
140;;
141;; Viper's Vi state consists of seven minor modes:
142;;
8626cfa2
MK
143;; viper-vi-intercept-minor-mode
144;; viper-vi-local-user-minor-mode
145;; viper-vi-global-user-minor-mode
146;; viper-vi-kbd-minor-mode
147;; viper-vi-state-modifier-minor-mode
148;; viper-vi-diehard-minor-mode
149;; viper-vi-basic-minor-mode
6c2e12f4
KH
150;;
151;; Bindings done to the keymap of the first mode overshadow those done to
152;; the second, which, in turn, overshadows those done to the third, etc.
153;;
8626cfa2 154;; The last viper-vi-basic-minor-mode contains most of the usual Vi bindings
3af0304a 155;; in its edit mode. This mode provides access to all Emacs facilities.
1e70790f 156;; Novice users, however, may want to set their viper-expert-level to 1
3af0304a 157;; in their .viper file. This will enable viper-vi-diehard-minor-mode. This
6c2e12f4
KH
158;; minor mode's bindings make Viper simulate the usual Vi very closely.
159;; For instance, C-c will not have its standard Emacs binding
160;; and so many of the goodies of Emacs are not available.
161;;
3af0304a 162;; A skilled user should set viper-expert-level to at least 3. This will
d63a37ea 163;; enable `C-c' and many Emacs facilities will become available.
8626cfa2 164;; In this case, viper-vi-diehard-minor-mode is inactive.
6c2e12f4
KH
165;;
166;; Viper gurus should have at least
1e70790f 167;; (setq viper-expert-level 4)
3af0304a 168;; in their ~/.viper files. This will unsuppress all Emacs keys that are not
6c2e12f4
KH
169;; essential for VI-style editing.
170;; Pick-and-choose users may want to put
1e70790f 171;; (setq viper-expert-level 5)
3af0304a 172;; in ~/.viper. Viper will then leave it up to the user to set the variables
8626cfa2 173;; viper-want-* See viper-set-expert-level for details.
6c2e12f4 174;;
8626cfa2 175;; The very first minor mode, viper-vi-intercept-minor-mode, is of no
3af0304a 176;; concern for the user. It is needed to bind Viper's vital keys, such as
6c2e12f4
KH
177;; ESC and C-z.
178;;
8626cfa2 179;; The second mode, viper-vi-local-user-minor-mode, usually has an
3af0304a 180;; empty keymap. However, the user can set bindings in this keymap, which
6c2e12f4 181;; will overshadow the corresponding bindings in the other two minor
3af0304a 182;; modes. This is useful, for example, for setting up ZZ in gnus,
6c2e12f4
KH
183;; rmail, mh-e, etc., to send message instead of saving it in a file.
184;; Likewise, in Dired mode, you may want to bind ZN and ZP to commands
185;; that would visit the next or the previous file in the Dired buffer.
3af0304a 186;; Setting local keys is tricky, so don't do it directly. Instead, use
8626cfa2 187;; viper-add-local-keys function (see its doc).
6c2e12f4 188;;
8626cfa2
MK
189;; The third minor mode, viper-vi-global-user-minor-mode, is also intended
190;; for the users but, unlike viper-vi-local-user-minor-mode, its key
3af0304a 191;; bindings are seen in all Viper buffers. This mode keys can be done
6c2e12f4
KH
192;; with define-key command.
193;;
8626cfa2 194;; The fourth minor mode, viper-vi-kbd-minor-mode, is used by keyboard
3af0304a 195;; macros. Users are NOT supposed to modify this keymap directly.
6c2e12f4 196;;
8626cfa2 197;; The fifth mode, viper-vi-state-modifier-minor-mode, can be used to set
6c2e12f4
KH
198;; key bindings that are visible in some major modes but not in others.
199;;
200;; Users are allowed to modify keymaps that belong to
8626cfa2
MK
201;; viper-vi-local-user-minor-mode, viper-vi-global-user-minor-mode,
202;; and viper-vi-state-modifier-minor-mode only.
6c2e12f4
KH
203;;
204;; Viper's Insert state also has seven minor modes:
205;;
8626cfa2
MK
206;; viper-insert-intercept-minor-mode
207;; viper-insert-local-user-minor-mode
208;; viper-insert-global-user-minor-mode
209;; viper-insert-kbd-minor-mode
210;; viper-insert-state-modifier-minor-mode
211;; viper-insert-diehard-minor-mode
212;; viper-insert-basic-minor-mode
6c2e12f4 213;;
8626cfa2
MK
214;; As with VI's editing modes, the first mode,
215;; viper-insert-intercept-minor-mode is used to bind vital keys that are not
216;; to be changed by the user.
6c2e12f4 217;;
8626cfa2 218;; The next mode, viper-insert-local-user-minor-mode, is used to customize
3af0304a 219;; bindings in the insert state of Viper. The third mode,
8626cfa2
MK
220;; viper-insert-global-user-minor-mode is like
221;; viper-insert-local-user-minor-mode, except that its bindings are seen in
3af0304a
MK
222;; all Viper buffers. As with viper-vi-local-user-minor-mode, its bindings
223;; should be done via the function viper-add-local-keys. Bindings for
8626cfa2 224;; viper-insert-global-user-minor-mode can be set with the define-key command.
6c2e12f4 225;;
8626cfa2 226;; The next minor mode, viper-insert-kbd-minor-mode,
a1506d29 227;; is used for keyboard VI-style macros defined with :map!.
6c2e12f4 228;;
8626cfa2
MK
229;; The fifth minor mode, viper-insert-state-modifier-minor-mode, is like
230;; viper-vi-state-modifier-minor-mode, except that it is used in the Insert
a1506d29 231;; state; it can be used to modify keys in a mode-specific fashion.
6c2e12f4 232;;
8626cfa2 233;; The minor mode viper-insert-diehard-minor-mode is in effect when
6c2e12f4 234;; the user wants a high degree of Vi compatibility (a bad idea, really!).
8626cfa2 235;; The last minor mode, viper-insert-basic-minor-mode, is always in effect
3af0304a 236;; when Viper is in insert state. It binds a small number of keys needed for
a1506d29 237;; Viper's operation.
6c2e12f4
KH
238;;
239;; Finally, Viper provides minor modes for overriding bindings set by Emacs
240;; modes when Viper is in Emacs state:
241;;
8626cfa2
MK
242;; viper-emacs-local-user-minor-mode
243;; viper-emacs-global-user-minor-mode
244;; viper-emacs-kbd-minor-mode
245;; viper-emacs-state-modifier-minor-mode
6c2e12f4 246;;
3af0304a 247;; These minor modes are in effect when Viper is in Emacs state. The keymap
8626cfa2
MK
248;; associated with viper-emacs-global-user-minor-mode,
249;; viper-emacs-global-user-map, overrides the global and local keymaps as
3af0304a 250;; well as the minor mode keymaps set by other modes. The keymap of
8626cfa2 251;; viper-emacs-local-user-minor-mode, viper-emacs-local-user-map, overrides
6c2e12f4 252;; everything, but it is used on a per buffer basis.
8626cfa2 253;; The keymap associated with viper-emacs-state-modifier-minor-mode
3af0304a 254;; overrides keys on a per-major-mode basis. The mode
8626cfa2 255;; viper-emacs-kbd-minor-mode is used to define Vi-style macros in Emacs
6c2e12f4
KH
256;; state.
257;;
258;; 3. There is also one minor mode that is used when Viper is in its
3af0304a 259;; replace-state (used for commands like cw, C, etc.). This mode is
6c2e12f4
KH
260;; called
261;;
8626cfa2 262;; viper-replace-minor-mode
6c2e12f4 263;;
3af0304a 264;; and its keymap is viper-replace-map. Replace minor mode is always
6c2e12f4
KH
265;; used in conjunction with the minor modes for insert-state, and its
266;; keymap overshadows the keymaps for insert minor modes.
267;;
a1506d29 268;; 4. Defining buffer-local bindings in Vi and Insert modes.
6c2e12f4
KH
269;; As mentioned before, sometimes, it is convenient to have
270;; buffer-specific of mode-specific key bindings in Vi and insert modes.
8626cfa2 271;; Viper provides a special function, viper-add-local-keys, to do precisely
3af0304a 272;; this. For instance, is you need to add couple of mode-specific bindings
a1506d29 273;; to Insert mode, you can put
6c2e12f4 274;;
a1506d29 275;; (viper-add-local-keys 'insert-state '((key1 . func1) (key2 .func2)))
6c2e12f4 276;;
3af0304a 277;; somewhere in a hook of this major mode. If you put something like this
6c2e12f4 278;; in your own elisp function, this will define bindings specific to the
8626cfa2 279;; buffer that was current at the time of the call to viper-add-local-keys.
6c2e12f4
KH
280;; The only thing to make sure here is that the major mode of this buffer
281;; is written according to Emacs conventions, which includes a call to
3af0304a 282;; (kill-all-local-variables). See viper-add-local-keys for more details.
6c2e12f4
KH
283;;
284;;
285;; TO DO (volunteers?):
286;;
287;; 1. Some of the code that is inherited from VIP-3.5 is rather
3af0304a
MK
288;; convoluted. Instead of viper-command-argument, keymaps should bind the
289;; actual commands. E.g., "dw" should be bound to a generic command
8626cfa2 290;; viper-delete that will delete things based on the value of
a4d9b7bc 291;; last-command-event. This would greatly simplify the logic and the code.
6c2e12f4
KH
292;;
293;; 2. Somebody should venture to write a customization package a la
294;; options.el that would allow the user to change values of variables
295;; that meet certain specs (e.g., match a regexp) and whose doc string
3af0304a
MK
296;; starts with a '*'. Then, the user should be offered to save
297;; variables that were changed. This will make user's customization job
6c2e12f4
KH
298;; much easier.
299;;
300
60370d40 301;;; Code:
6c2e12f4 302
726e270f
MK
303;; compiler pacifier
304(defvar mark-even-if-inactive)
34317da2 305(defvar quail-mode)
1e70790f 306(defvar viper-expert-level)
2eb4bdca
MK
307(defvar viper-mode-string)
308(defvar viper-major-mode-modifier-list)
726e270f 309;; end pacifier
6c2e12f4 310
cdd489b0 311(require 'advice)
aca9b721 312(require 'viper-init)
8ea74b0e 313(require 'viper-keym)
aca9b721 314
1e70790f 315;; better be defined before Viper custom group.
940e5099 316(defvar viper-custom-file-name (locate-user-emacs-file "viper" ".viper")
33c053f4 317 "Viper customization file.
1e70790f
MK
318If set by the user, this must be done _before_ Viper is loaded in `~/.emacs'.")
319
320(defgroup viper nil
321 "Vi emulation within Emacs.
8626cfa2 322NOTE: Viper customization should be saved in `viper-custom-file-name', which
1e70790f 323defaults to `~/.viper'."
8626cfa2 324 :prefix "viper-"
1e70790f
MK
325 :group 'emulations)
326
726e270f 327(require 'viper-cmd)
6c2e12f4 328
8e41a31c
MK
329(defgroup viper-misc nil
330 "Miscellaneous Viper customization."
331 :prefix "viper-"
332 :group 'viper)
333
334
8626cfa2 335(defcustom viper-always t
e36a387d
MK
336 "Non-nil means, arrange for vi-state to be a default when appropriate.
337This is different from `viper-mode' variable in that `viper-mode' determines
338whether to use Viper in the first place, while `viper-always', if nil, lets
1e70790f
MK
339user decide when to invoke Viper in a major mode."
340 :type 'boolean
341 :tag "Always Invoke Viper"
8e41a31c 342 :group 'viper-misc)
1e70790f
MK
343
344;; Non-viper variables that need to be saved in case the user decides to
345;; de-viperize emacs.
346(defvar viper-saved-non-viper-variables nil)
a1506d29 347
1e70790f
MK
348(defcustom viper-mode (cond (noninteractive nil)
349 (t 'ask))
350 "To Viperize or not to Viperize.
cbd9191d 351If t, viperize Emacs. If nil -- don't. If `ask', ask the user.
33c053f4 352This variable is used primarily when Viper is being loaded.
6c2e12f4 353
865fe16f 354Must be set in your init file before Viper is loaded.
8e41a31c
MK
355DO NOT set this variable interactively, unless you are using the customization
356widget."
1e70790f
MK
357 :type '(choice (const nil) (const t) (const ask))
358 :tag "Set Viper Mode on Loading"
8e41a31c 359 :group 'viper-misc)
726e270f 360
2eb4bdca
MK
361(defcustom viper-vi-state-mode-list
362 '(fundamental-mode
363 makefile-mode
a1506d29 364
2eb4bdca
MK
365 awk-mode
366 m4-mode
3af0304a
MK
367 xrdb-mode
368 winmgr-mode
369 autoconf-mode
370 cvs-edit-mode
a1506d29 371
2eb4bdca
MK
372 html-mode html-helper-mode
373 emacs-lisp-mode lisp-mode lisp-interaction-mode
a1506d29
JB
374
375 jde-mode java-mode
3af0304a 376 cc-mode c-mode c++-mode objc-mode
2eb4bdca
MK
377 fortran-mode f90-mode
378 basic-mode
379 bat-mode
380 asm-mode
381 prolog-mode
3af0304a 382 flora-mode
55d7ff38 383 sql-mode
2eb4bdca
MK
384
385 text-mode indented-text-mode
386 tex-mode latex-mode bibtex-mode
55d7ff38 387 ps-mode
a1506d29 388
38685583 389 ;; completion-list-mode
560ef11a 390 diff-mode
4960e757 391 idl-mode
a1506d29 392
4986c2c6
MK
393 perl-mode
394 cperl-mode
2eb4bdca
MK
395 javascript-mode
396 tcl-mode
397 python-mode
a1506d29 398
2eb4bdca 399 sh-mode ksh-mode csh-mode
a1506d29 400
2eb4bdca
MK
401 gnus-article-mode
402 mh-show-mode
403 )
404 "Major modes that require Vi command state."
085d6698 405 :type '(repeat symbol)
8e41a31c 406 :group 'viper-misc)
c81246f3 407
2eb4bdca 408(defcustom viper-emacs-state-mode-list
27eb24a3 409 '(Custom-mode
2eb4bdca
MK
410
411 dired-mode
412 efs-mode
413 tar-mode
f1e6674b 414 egg-status-buffer-mode
2eb4bdca 415
f3eabcdf
MK
416 browse-kill-ring-mode
417 recentf-mode
44766d63 418 recentf-dialog-mode
f3eabcdf
MK
419 occur-mode
420
2eb4bdca
MK
421 mh-folder-mode
422 gnus-group-mode
423 gnus-summary-mode
a1506d29 424
38685583
MK
425 completion-list-mode
426 help-mode
427
2eb4bdca
MK
428 Info-mode
429 Buffer-menu-mode
3af0304a 430 compilation-mode
a1506d29 431
54b171c7
MK
432 rcirc-mode
433
0680ea10
MK
434 jde-javadoc-checker-report-mode
435
2eb4bdca
MK
436 view-mode
437 vm-mode
438 vm-summary-mode)
fb7ada5f 439 "A list of major modes that should come up in Emacs state.
2eb4bdca
MK
440Normally, Viper would bring buffers up in Emacs state, unless the corresponding
441major mode has been placed on `viper-vi-state-mode-list' or
3af0304a
MK
442`viper-insert-state-mode-list'. So, don't place a new mode on this list,
443unless it is coming up in a wrong Viper state."
2eb4bdca
MK
444 :type '(repeat symbol)
445 :group 'viper-misc)
446
447(defcustom viper-insert-state-mode-list
657f9cb8
MK
448 '(internal-ange-ftp-mode
449 comint-mode
ac64a728 450 gud-mode
4960e757 451 inferior-emacs-lisp-mode
98c414c7 452 erc-mode
657f9cb8
MK
453 eshell-mode
454 shell-mode)
fb7ada5f 455 "A list of major modes that should come up in Vi Insert state."
2eb4bdca
MK
456 :type '(repeat symbol)
457 :group 'viper-misc)
458
459
460;; used to set viper-major-mode-modifier-list in defcustom
461(defun viper-apply-major-mode-modifiers (&optional symbol value)
462 (if symbol
463 (set symbol value))
3af0304a
MK
464 (mapcar (lambda (triple)
465 (viper-modify-major-mode
466 (nth 0 triple) (nth 1 triple) (eval (nth 2 triple))))
2eb4bdca
MK
467 viper-major-mode-modifier-list))
468
3f9526a3 469;; We change standard bindings in some major modes, making them slightly
4960e757 470;; different than in "normal" vi/insert/emacs states
2eb4bdca
MK
471(defcustom viper-major-mode-modifier-list
472 '((help-mode emacs-state viper-slash-and-colon-map)
473 (comint-mode insert-state viper-comint-mode-modifier-map)
474 (comint-mode vi-state viper-comint-mode-modifier-map)
ac64a728 475 (gud-mode insert-state viper-comint-mode-modifier-map)
2eb4bdca 476 (shell-mode insert-state viper-comint-mode-modifier-map)
4960e757 477 (inferior-emacs-lisp-mode insert-state viper-comint-mode-modifier-map)
2eb4bdca
MK
478 (shell-mode vi-state viper-comint-mode-modifier-map)
479 (ange-ftp-shell-mode insert-state viper-comint-mode-modifier-map)
480 (ange-ftp-shell-mode vi-state viper-comint-mode-modifier-map)
481 (internal-ange-ftp-mode insert-state viper-comint-mode-modifier-map)
482 (internal-ange-ftp-mode vi-state viper-comint-mode-modifier-map)
483 (dired-mode emacs-state viper-dired-modifier-map)
484 (tar-mode emacs-state viper-slash-and-colon-map)
485 (mh-folder-mode emacs-state viper-slash-and-colon-map)
3f9526a3
MK
486 (gnus-group-mode emacs-state viper-gnus-modifier-map)
487 (gnus-summary-mode emacs-state viper-gnus-modifier-map)
2eb4bdca
MK
488 (Info-mode emacs-state viper-slash-and-colon-map)
489 (Buffer-menu-mode emacs-state viper-slash-and-colon-map)
98c414c7
MB
490 (erc-mode insert-state viper-comint-mode-modifier-map)
491 (erc-mode vi-state viper-comint-mode-modifier-map)
2eb4bdca
MK
492 )
493 "List specifying how to modify the various major modes to enable some Viperisms.
494The list has the structure: ((mode viper-state keymap) (mode viper-state
c80e3b4a 495keymap) ...). If `mode' is on the list, the `keymap' will be made active (on
3af0304a 496the minor-mode-map-alist) in the specified viper state.
cbd9191d
JB
497If you change this list, have to restart Emacs for the change to take effect.
498However, if you did the change through the customization widget, then Emacs
2eb4bdca 499needs to be restarted only if you deleted a triple mode-state-keymap from the
cbd9191d 500list. No need to restart Emacs in case of insertion or modification of an
2eb4bdca
MK
501existing triple."
502 :type '(repeat
503 (list symbol
504 (choice (const emacs-state)
505 (const vi-state)
506 (const insert-state))
507 symbol))
508 :set 'viper-apply-major-mode-modifiers
509 :group 'viper-misc)
510
511
c81246f3 512
e36a387d 513\f
726e270f 514
e36a387d 515;;;###autoload
8626cfa2 516(defun toggle-viper-mode ()
328b4b70 517 "Toggle Viper on/off.
3af0304a 518If Viper is enabled, turn it off. Otherwise, turn it on."
8626cfa2
MK
519 (interactive)
520 (if (eq viper-mode t)
521 (viper-go-away)
522 (setq viper-mode nil)
523 (viper-mode)))
6c2e12f4 524
e36a387d
MK
525;;;###autoload
526(defun viper-mode ()
61c4714e 527 "Turn on Viper emulation of Vi in Emacs. See Info node `(viper)Top'."
e36a387d
MK
528 (interactive)
529 (if (not noninteractive)
530 (progn
531 ;; if the user requested viper-mode explicitly
532 (if viper-mode
533 ()
8626cfa2 534 (setq viper-mode t)
e36a387d
MK
535 (load-library "viper"))
536
a1506d29 537 (if viper-first-time ; Important check. Prevents mix-up of startup
3af0304a 538 (progn ; and expert-level msgs when viper-mode recurses
8626cfa2
MK
539 (setq viper-first-time nil)
540 (if (not viper-inhibit-startup-message)
e36a387d 541 (save-window-excursion
8626cfa2 542 (setq viper-inhibit-startup-message t)
e36a387d
MK
543 (delete-other-windows)
544 (switch-to-buffer "Viper Startup Message")
545 (erase-buffer)
546 (insert
547 (substitute-command-keys
1e70790f
MK
548 "Viper Is a Package for Emacs Rebels,
549a VI Plan for Emacs Rescue, and a venomous VI PERil.
e36a387d 550
8831bbed 551Incidentally, Viper emulates Vi under Emacs/XEmacs 20.
1e70790f 552It supports all of what is good in Vi and Ex, while extending
e36a387d
MK
553and improving upon much of it.
554
3af0304a 555 1. Viper supports Vi at several levels. Level 1 is the closest to Vi,
e36a387d 556 level 5 provides the most flexibility to depart from many Vi conventions.
a1506d29 557
e36a387d 558 You will be asked to specify your user level in a following screen.
a1506d29 559
e36a387d 560 If you select user level 1 then the keys ^X, ^C, ^Z, and ^G will behave
3af0304a 561 as in VI, to smooth transition to Viper for the beginners. However, to
a1506d29
JB
562 use Emacs productively, you are advised to reach user level 3 or higher.
563
1e70790f 564 At user level 2 or higher, ^X and ^C have Emacs, not Vi, bindings;
44e97401 565 ^Z toggles Vi/Emacs states; ^G is Emacs's keyboard-quit (like ^C in Vi).
a1506d29 566
e36a387d 567 2. Vi exit functions (e.g., :wq, ZZ) work on INDIVIDUAL files -- they
1e70790f 568 do not cause Emacs to quit, except at user level 1 (for a novice).
e36a387d 569 3. ^X^C EXITS EMACS.
3af0304a
MK
570 4. Viper supports multiple undo: `u' will undo. Typing `.' will repeat
571 undo. Another `u' changes direction.
a1506d29 572
1e70790f
MK
573 6. Emacs Meta key is `C-\\' (in all modes) or `\\ ESC' (in Vi command mode).
574 On a window system, the best way is to use the Meta-key on your keyboard.
e36a387d 575 7. Try \\[keyboard-quit] and \\[abort-recursive-edit] repeatedly,if
a1506d29
JB
576 something funny happens. This would abort the current editing command.
577
1e70790f 578For more information on Viper:
726e270f 579
1e70790f
MK
580 a. Type `:help' in Vi command mode
581 b. Print Viper manual, found in ./etc/viper.dvi
582 c. Print the Quick Reference, found in ./etc/viperCard.dvi
583
584To submit a bug report or to contact the author, type :submitReport in Vi
3af0304a 585command mode. To shoo Viper away and return to pure Emacs (horror!), type:
1e70790f
MK
586
587 M-x viper-go-away
a1506d29 588
e36a387d
MK
589This startup message appears whenever you load Viper, unless you type `y' now."
590 ))
591 (goto-char (point-min))
592 (if (y-or-n-p "Inhibit Viper startup message? ")
8626cfa2
MK
593 (viper-save-setting
594 'viper-inhibit-startup-message
e36a387d 595 "Viper startup message inhibited"
8626cfa2 596 viper-custom-file-name t))
e36a387d
MK
597 ;;(kill-buffer (current-buffer))
598 (message
599 "The last message is in buffer `Viper Startup Message'")
600 (sit-for 4)
601 ))
1e70790f 602 (viper-set-expert-level 'dont-change-unless)))
c81246f3 603
2eb4bdca
MK
604 (or (memq major-mode viper-emacs-state-mode-list) ; don't switch to Vi
605 (memq major-mode viper-insert-state-mode-list) ; don't switch
83f49acb 606 (viper-change-state-to-vi))
2ee00512
MK
607 ))
608
609 (if (eq major-mode 'viper-mode)
610 (setq major-mode 'fundamental-mode))
611 )
a1506d29 612
4960e757
MK
613
614;; Apply a little heuristic to invoke vi state on major-modes
615;; that are not listed in viper-vi-state-mode-list
616(defun this-major-mode-requires-vi-state (mode)
617 (cond ((memq mode viper-vi-state-mode-list) t)
618 ((memq mode viper-emacs-state-mode-list) nil)
619 ((memq mode viper-insert-state-mode-list) nil)
620 (t (and (eq (key-binding "a") 'self-insert-command)
621 (eq (key-binding " ") 'self-insert-command)))))
622
6c2e12f4 623\f
4af0c23b 624;; This hook designed to enable Vi-style editing in comint-based modes."
8626cfa2 625(defun viper-comint-mode-hook ()
e2de3a29
MK
626 (set (make-local-variable 'require-final-newline) nil)
627 (setq viper-ex-style-editing nil
8626cfa2
MK
628 viper-ex-style-motion nil)
629 (viper-change-state-to-insert))
34da0a2b 630
6c2e12f4 631
1e70790f
MK
632;; remove viper hooks from SYMBOL
633(defun viper-remove-hooks (symbol)
634 (cond ((not (boundp symbol)) nil)
635 ((not (listp (eval symbol))) nil)
636 ((string-match "-hook" (symbol-name symbol))
637 (remove-hook symbol 'viper-mode)
8626cfa2
MK
638 (remove-hook symbol 'viper-change-state-to-emacs)
639 (remove-hook symbol 'viper-change-state-to-insert)
640 (remove-hook symbol 'viper-change-state-to-vi)
69441214
MK
641 (remove-hook symbol 'viper-minibuffer-post-command-hook)
642 (remove-hook symbol 'viper-minibuffer-setup-sentinel)
643 (remove-hook symbol 'viper-major-mode-change-sentinel)
644 (remove-hook symbol 'set-viper-state-in-major-mode)
645 (remove-hook symbol 'viper-post-command-sentinel)
1e70790f
MK
646 )))
647
648;; Remove local value in all existing buffers
649;; This doesn't delocalize vars (which would have been desirable)
650(defun viper-delocalize-var (symbol)
937e6a56
SM
651 (dolist (buf (buffer-list))
652 (with-current-buffer buf
653 (kill-local-variable symbol))))
1e70790f
MK
654
655
656(defun viper-go-away ()
657 "De-Viperize Emacs.
3af0304a
MK
658This function tries to do as good a job as possible. However, it may undo some
659user customization, unrelated to Viper. For instance, if the user advised
1e70790f
MK
660`read-file-name', `describe-key', and some others, then this advice will be
661undone.
38685583 662It also can't undo some Viper settings."
1e70790f 663 (interactive)
f1e6674b 664 (viper-setup-ESC-to-escape nil)
1e70790f
MK
665 ;; restore non-viper vars
666 (setq-default
1e70790f 667 next-line-add-newlines
a1506d29
JB
668 (viper-standard-value
669 'next-line-add-newlines viper-saved-non-viper-variables)
1e70790f 670 require-final-newline
a1506d29
JB
671 (viper-standard-value
672 'require-final-newline viper-saved-non-viper-variables)
1e70790f 673 scroll-step
a1506d29 674 (viper-standard-value 'scroll-step viper-saved-non-viper-variables)
1e70790f
MK
675 mode-line-buffer-identification
676 (viper-standard-value
5489c3d3
MK
677 'mode-line-buffer-identification viper-saved-non-viper-variables)
678 global-mode-string
c004db97 679 (delq 'viper-mode-string global-mode-string))
5489c3d3 680
14acf2f5
SM
681 (setq-default major-mode
682 (viper-standard-value 'default-major-mode
683 viper-saved-non-viper-variables))
69441214 684
e83d1fe8 685 (if (featurep 'emacs)
5489c3d3
MK
686 (setq-default
687 mark-even-if-inactive
688 (viper-standard-value
689 'mark-even-if-inactive viper-saved-non-viper-variables)))
1e70790f 690
a1506d29 691 ;; Ideally, we would like to be able to de-localize local variables
38685583
MK
692 (unless
693 (and (fboundp 'add-to-ordered-list) (boundp 'emulation-mode-map-alists))
694 (viper-delocalize-var 'minor-mode-map-alist))
1e70790f 695 (viper-delocalize-var 'require-final-newline)
e83d1fe8 696 (if (featurep 'xemacs) (viper-delocalize-var 'bar-cursor))
1e70790f 697
a1506d29 698
1e70790f 699 ;; deactivate all advices done by Viper.
8626cfa2 700 (ad-deactivate-regexp "viper-")
1e70790f
MK
701
702 (setq viper-mode nil)
703
8ea74b0e
MK
704 (when (and (fboundp 'add-to-ordered-list) (boundp 'emulation-mode-map-alists))
705 (setq emulation-mode-map-alists
706 (delq 'viper--intercept-key-maps
707 (delq 'viper--key-maps emulation-mode-map-alists))
708 ))
709
8626cfa2
MK
710 (viper-delocalize-var 'viper-vi-minibuffer-minor-mode)
711 (viper-delocalize-var 'viper-insert-minibuffer-minor-mode)
712 (viper-delocalize-var 'viper-vi-intercept-minor-mode)
713 (viper-delocalize-var 'viper-insert-intercept-minor-mode)
a1506d29 714
8626cfa2
MK
715 (viper-delocalize-var 'viper-vi-local-user-minor-mode)
716 (viper-delocalize-var 'viper-vi-kbd-minor-mode)
717 (viper-delocalize-var 'viper-vi-global-user-minor-mode)
718 (viper-delocalize-var 'viper-vi-state-modifier-minor-mode)
719 (viper-delocalize-var 'viper-vi-diehard-minor-mode)
720 (viper-delocalize-var 'viper-vi-basic-minor-mode)
a1506d29 721
8626cfa2 722 (viper-delocalize-var 'viper-replace-minor-mode)
a1506d29 723
8626cfa2
MK
724 (viper-delocalize-var 'viper-insert-local-user-minor-mode)
725 (viper-delocalize-var 'viper-insert-kbd-minor-mode)
726 (viper-delocalize-var 'viper-insert-global-user-minor-mode)
727 (viper-delocalize-var 'viper-insert-state-modifier-minor-mode)
728 (viper-delocalize-var 'viper-insert-diehard-minor-mode)
729 (viper-delocalize-var 'viper-insert-basic-minor-mode)
a1506d29 730
8626cfa2
MK
731 (viper-delocalize-var 'viper-emacs-intercept-minor-mode)
732 (viper-delocalize-var 'viper-emacs-local-user-minor-mode)
733 (viper-delocalize-var 'viper-emacs-kbd-minor-mode)
734 (viper-delocalize-var 'viper-emacs-global-user-minor-mode)
735 (viper-delocalize-var 'viper-emacs-state-modifier-minor-mode)
736
c004db97
MK
737 (viper-delocalize-var 'viper-current-state)
738 (viper-delocalize-var 'viper-mode-string)
739
8626cfa2
MK
740 (setq-default viper-vi-minibuffer-minor-mode nil
741 viper-insert-minibuffer-minor-mode nil
742 viper-vi-intercept-minor-mode nil
743 viper-insert-intercept-minor-mode nil
a1506d29 744
8626cfa2
MK
745 viper-vi-local-user-minor-mode nil
746 viper-vi-kbd-minor-mode nil
747 viper-vi-global-user-minor-mode nil
748 viper-vi-state-modifier-minor-mode nil
749 viper-vi-diehard-minor-mode nil
750 viper-vi-basic-minor-mode nil
a1506d29 751
8626cfa2 752 viper-replace-minor-mode nil
a1506d29 753
8626cfa2
MK
754 viper-insert-local-user-minor-mode nil
755 viper-insert-kbd-minor-mode nil
756 viper-insert-global-user-minor-mode nil
757 viper-insert-state-modifier-minor-mode nil
758 viper-insert-diehard-minor-mode nil
759 viper-insert-basic-minor-mode nil
760
761 viper-emacs-intercept-minor-mode nil
762 viper-emacs-local-user-minor-mode nil
763 viper-emacs-kbd-minor-mode nil
764 viper-emacs-global-user-minor-mode nil
765 viper-emacs-state-modifier-minor-mode nil
c004db97
MK
766
767 viper-current-state 'emacs-state
768 viper-mode-string viper-emacs-state-id
1e70790f
MK
769 )
770
771 ;; remove all hooks set by viper
772 (mapatoms 'viper-remove-hooks)
8626cfa2 773 (remove-hook 'comint-mode-hook 'viper-comint-mode-hook)
98c414c7 774 (remove-hook 'erc-mode-hook 'viper-comint-mode-hook)
2eb4bdca 775 (remove-hook 'change-major-mode-hook 'viper-major-mode-change-sentinel)
8626cfa2
MK
776
777 ;; unbind Viper mouse bindings
778 (viper-unbind-mouse-search-key)
779 (viper-unbind-mouse-insert-key)
41497c90 780 ;; In emacs, we have to advice handle-switch-frame
53964682 781 ;; This advice is undone earlier, when all advices matching "viper-" are
41497c90 782 ;; deactivated.
e83d1fe8 783 (if (featurep 'xemacs)
41497c90
MK
784 (remove-hook 'mouse-leave-frame-hook 'viper-remember-current-frame))
785 ) ; end viper-go-away
1e70790f
MK
786
787
2eb4bdca
MK
788;; list of buffers that just changed their major mode
789;; used in a hack that triggers vi command mode whenever needed
790(defvar viper-new-major-mode-buffer-list nil)
791
792;; set appropriate Viper state in buffers that changed major mode
793(defun set-viper-state-in-major-mode ()
5078a328 794 (mapc
3af0304a
MK
795 (lambda (buf)
796 (if (viper-buffer-live-p buf)
797 (with-current-buffer buf
4960e757 798 (cond ((and (this-major-mode-requires-vi-state major-mode)
3af0304a
MK
799 (eq viper-current-state 'emacs-state))
800 (viper-mode))
801 ((memq major-mode viper-emacs-state-mode-list)
802 ;; not checking (eq viper-current-state 'emacs-state)
803 ;; because viper-current-state could have gotten it by
804 ;; default. We need viper-change-state-to-emacs here to have
805 ;; the keymaps take effect.
806 (viper-change-state-to-emacs))
807 ((and (memq major-mode viper-insert-state-mode-list)
808 (not (eq viper-current-state 'insert-state)))
809 (viper-change-state-to-insert))
810 )) ; with-current-buffer
811 )) ; function
2eb4bdca
MK
812 viper-new-major-mode-buffer-list)
813 ;; clear the list of bufs that changed major mode
814 (setq viper-new-major-mode-buffer-list nil)
815 ;; change the global value of hook
816 (remove-hook 'viper-post-command-hooks 'set-viper-state-in-major-mode))
817
818;; sets up post-command-hook to turn viper-mode, if the current mode is
819;; fundamental
820(defun viper-major-mode-change-sentinel ()
821 (save-match-data
822 (or (string-match "\*Minibuf-" (buffer-name))
a1506d29 823 (setq viper-new-major-mode-buffer-list
2eb4bdca
MK
824 (cons (current-buffer) viper-new-major-mode-buffer-list))))
825 ;; change the global value of hook
826 (add-hook 'viper-post-command-hooks 'set-viper-state-in-major-mode t))
827
1e70790f 828
f1e6674b
MK
829;;; Handling of tty's ESC event
830
831;; On a tty, an ESC event can either be the user hitting the escape key, or
832;; some element of a byte sequence used to encode for example cursor keys.
833;; So we try to recognize those events that correspond to the escape key and
834;; turn them into `escape' events (same as used under GUIs). The heuristic we
835;; use to distinguish the two cases is based, as usual, on a timeout, and on
836;; the fact that the special ESC=>escape mapping only takes place if the whole
837;; last key-sequence so far is just [?\e], i.e. either we're still in
838;; read-key-sequence, or the last read-key-sequence only read [?\e], which
839;; should ideally never happen because it should have been mapped to [escape].
840
841(defun viper--tty-ESC-filter (map)
842 (if (and (equal (this-single-command-keys) [?\e])
843 (sit-for (/ viper-fast-keyseq-timeout 1000)))
844 [escape] map))
845
846(defun viper--lookup-key (map key)
847 "Kind of like `lookup-key'.
848Two differences:
849- KEY is a single key, not a sequence.
850- the result is the \"raw\" binding, so it can be a `menu-item', rather than the
851 binding contained in that menu item."
852 (catch 'found
853 (map-keymap (lambda (k b) (if (equal key k) (throw 'found b))) map)))
854
855(defun viper-catch-tty-ESC ()
856 "Setup key mappings of current terminal to turn a tty's ESC into `escape'."
857 (when (memq (terminal-live-p (frame-terminal)) '(t pc))
858 (let ((esc-binding (viper-uncatch-tty-ESC)))
859 (define-key input-decode-map
860 [?\e] `(menu-item "" ,esc-binding :filter viper--tty-ESC-filter)))))
861
862(defun viper-uncatch-tty-ESC ()
863 "Don't hack ESC into `escape' any more."
864 (let ((b (viper--lookup-key input-decode-map ?\e)))
865 (and (eq 'menu-item (car-safe b))
866 (eq 'viper--tty-ESC-filter (nth 4 b))
867 (define-key input-decode-map [?\e] (setq b (nth 2 b))))
868 b))
869
870(defun viper-setup-ESC-to-escape (enable)
871 (if enable
872 (add-hook 'tty-setup-hook 'viper-catch-tty-ESC)
873 (remove-hook 'tty-setup-hook 'viper-catch-tty-ESC))
874 (let ((seen ()))
875 (dolist (frame (frame-list))
876 (let ((terminal (frame-terminal frame)))
877 (unless (memq terminal seen)
878 (push terminal seen)
879 (with-selected-frame frame
880 (if enable (viper-catch-tty-ESC) (viper-uncatch-tty-ESC))))))))
1e70790f 881
04090c34 882;; This sets major mode hooks to make them come up in vi-state.
8626cfa2 883(defun viper-set-hooks ()
6c2e12f4
KH
884 ;; It is of course a misnomer to call viper-mode a `major mode'.
885 ;; However, this has the effect that if the user didn't specify the
886 ;; default mode, new buffers that fall back on the default will come up
887 ;; in Fundamental Mode and Vi state.
4960e757
MK
888 ;; When viper-mode is executed in such a case, it will set the major mode
889 ;; back to fundamental-mode.
14acf2f5
SM
890 (if (eq (default-value 'major-mode) 'fundamental-mode)
891 (setq-default major-mode 'viper-mode))
a1506d29 892
f1e6674b
MK
893 (viper-setup-ESC-to-escape t)
894
2eb4bdca
MK
895 (add-hook 'change-major-mode-hook 'viper-major-mode-change-sentinel)
896 (add-hook 'find-file-hooks 'set-viper-state-in-major-mode)
e36a387d 897
2eb4bdca 898 ;; keep this because many modes we don't know about use this hook
bbe6126c 899 (defvar text-mode-hook)
6c2e12f4 900 (add-hook 'text-mode-hook 'viper-mode)
a1506d29 901
bbe6126c 902 (defvar emerge-startup-hook)
8626cfa2 903 (add-hook 'emerge-startup-hook 'viper-change-state-to-emacs)
34da0a2b 904
241d963d
MK
905 ;; if viper is started from .emacs, it might be impossible to get certain
906 ;; info about the display and windows until emacs initialization is complete
907 ;; So do it via the window-setup-hook
908 (add-hook 'window-setup-hook
4f91a816
SM
909 (lambda ()
910 (modify-frame-parameters
911 (selected-frame)
912 (list (cons 'viper-vi-state-cursor-color
913 (viper-get-cursor-color))))
914 (setq viper-vi-state-cursor-color (viper-get-cursor-color))
915 ))
b93e5ce2 916
34da0a2b 917 ;; Tell vc-diff to put *vc* in Vi mode
c3583c94
GM
918 (eval-after-load
919 "vc"
920 '(defadvice vc-diff (after viper-vc-ad activate)
921 "Force Vi state in VC diff buffer."
922 (viper-change-state-to-vi)))
a1506d29 923
8626cfa2 924 (eval-after-load
4af0c23b 925 "emerge"
8626cfa2
MK
926 '(defadvice emerge-quit (after viper-emerge-advice activate)
927 "Run `viper-change-state-to-vi' after quitting emerge."
928 (viper-change-state-to-vi)))
a1506d29 929
6c2e12f4 930 ;; passwd.el sets up its own buffer, which turns up in Vi mode,
3af0304a 931 ;; thus overriding the local map. We don't need Vi mode here.
8626cfa2 932 (eval-after-load
6c2e12f4 933 "passwd"
8626cfa2 934 '(defadvice read-passwd-1 (before viper-passwd-ad activate)
cbd9191d 935 "Switch to Emacs state while reading password."
8626cfa2 936 (viper-change-state-to-emacs)))
a1506d29 937
8ea74b0e
MK
938 (defadvice self-insert-command (around viper-self-insert-ad activate)
939 "Ignore all self-inserting keys in the vi-state."
32226619 940 (if (and (eq viper-current-state 'vi-state)
433d9ace
MK
941 ;; Do not use called-interactively-p here. XEmacs does not have it
942 ;; and interactive-p is just fine.
943 ;; (called-interactively-p 'interactive))
944 (interactive-p))
8ea74b0e
MK
945 (beep 1)
946 ad-do-it
947 ))
948
38685583
MK
949 (defadvice set-cursor-color (after viper-set-cursor-color-ad activate)
950 "Change cursor color in VI state."
38685583
MK
951 (modify-frame-parameters
952 (selected-frame)
953 (list (cons 'viper-vi-state-cursor-color (ad-get-arg 0))))
65efc538 954 (setq viper-vi-state-cursor-color (ad-get-arg 0))
38685583
MK
955 )
956
8ea74b0e
MK
957 (when (and (fboundp 'add-to-ordered-list) (boundp 'emulation-mode-map-alists))
958 ;; needs to be as early as possible
959 (add-to-ordered-list
960 'emulation-mode-map-alists 'viper--intercept-key-maps 100)
961 ;; needs to be after cua-mode
962 (add-to-ordered-list 'emulation-mode-map-alists 'viper--key-maps 500)
963 )
964
4af0c23b 965 ;; Emacs shell, ange-ftp, and comint-based modes
2eb4bdca 966 (add-hook 'comint-mode-hook 'viper-comint-mode-hook) ; comint
98c414c7 967 (add-hook 'erc-mode-hook 'viper-comint-mode-hook) ; ERC
34da0a2b 968
8ea74b0e
MK
969 (add-hook 'eshell-mode-hook
970 (lambda () (setq viper-auto-indent nil)))
971
2eb4bdca
MK
972 (viper-set-emacs-state-searchstyle-macros nil 'dired-mode) ; dired
973 (viper-set-emacs-state-searchstyle-macros nil 'tar-mode) ; tar
974 (viper-set-emacs-state-searchstyle-macros nil 'mh-folder-mode) ; mhe
975 (viper-set-emacs-state-searchstyle-macros nil 'gnus-group-mode) ; gnus
976 (viper-set-emacs-state-searchstyle-macros nil 'gnus-summary-mode)
977 (viper-set-emacs-state-searchstyle-macros nil 'Info-mode) ; info
978 (viper-set-emacs-state-searchstyle-macros nil 'Buffer-menu-mode) ;buffer-menu
34da0a2b 979
2eb4bdca
MK
980 ;; Modify major modes according to viper-major-mode-modifier-list
981 (viper-apply-major-mode-modifiers)
a1506d29 982
6c2e12f4
KH
983 ;; For RMAIL users.
984 ;; Put buf in Emacs state after edit.
8626cfa2 985 (eval-after-load
6c2e12f4 986 "rmailedit"
8626cfa2 987 '(defadvice rmail-cease-edit (after viper-rmail-advice activate)
cbd9191d 988 "Switch to Emacs state when done editing message."
8626cfa2 989 (viper-change-state-to-emacs)))
34317da2
MK
990
991 ;; ISO accents
992 ;; Need to do it after loading iso-acc, or else this loading will wipe out
993 ;; the advice.
994 (eval-after-load
995 "iso-acc"
90066cb5
RF
996 '(defadvice iso-accents-mode (around viper-iso-accents-advice activate)
997 "Set viper-automatic-iso-accents to iso-accents-mode."
998 (let ((arg (ad-get-arg 0)))
999 ad-do-it
1000 (setq viper-automatic-iso-accents
1001 (if (eq viper-current-state 'vi-state)
1002 (if arg
1003 ;; if iso-accents-mode was called with positive arg, turn
1004 ;; accents on
1005 (> (prefix-numeric-value arg) 0)
1006 ;; else: toggle viper-automatic-iso-accents
1007 (not viper-automatic-iso-accents))
1008 ;; other states: accept what iso-accents-mode has done
1009 iso-accents-mode))
1010 ;; turn off ISO accents in vi-state
1011 (if (eq viper-current-state 'vi-state)
1012 (viper-set-iso-accents-mode nil))
1013 (if (memq viper-current-state '(vi-state insert-state replace-state))
1014 (message "Viper ISO accents mode: %s"
1015 (if viper-automatic-iso-accents "on" "off")))
1016 )))
34317da2
MK
1017
1018 ;; International input methods
e83d1fe8 1019 (if (featurep 'emacs)
34317da2 1020 (eval-after-load "mule-cmds"
90066cb5 1021 '(progn
72b255c7 1022 (defadvice deactivate-input-method (after viper-mule-advice activate)
90066cb5 1023 "Set viper-special-input-method to disable intl. input methods."
72b255c7 1024 (viper-deactivate-input-method-action))
90066cb5
RF
1025 (defadvice activate-input-method (after viper-mule-advice activate)
1026 "Set viper-special-input-method to enable intl. input methods."
1027 (viper-activate-input-method-action))
1028 ))
34317da2
MK
1029 ;; XEmacs Although these hooks exist in Emacs, they don't seem to be always
1030 ;; called on input-method activation/deactivation, so we the above advise
1031 ;; functions instead.
1032 (eval-after-load "mule-cmds"
90066cb5
RF
1033 '(progn
1034 (add-hook 'input-method-activate-hook
1035 'viper-activate-input-method-action t)
72b255c7
PE
1036 (add-hook 'input-method-deactivate-hook
1037 'viper-deactivate-input-method-action t)))
34317da2
MK
1038 )
1039 (eval-after-load "mule-cmds"
90066cb5
RF
1040 '(defadvice toggle-input-method (around viper-mule-advice activate)
1041 "Adjust input-method toggling in vi-state."
1042 (if (and viper-special-input-method (eq viper-current-state 'vi-state))
72b255c7 1043 (viper-deactivate-input-method)
90066cb5 1044 ad-do-it)))
a1506d29 1045
8626cfa2 1046 ) ; viper-set-hooks
726e270f 1047
e36a387d
MK
1048
1049;; these are primarily advices and Vi-ish variable settings
8626cfa2
MK
1050(defun viper-non-hook-settings ()
1051
83f49acb
MK
1052 ;;;; Viper changes the default mode-line-buffer-identification
1053 ;;(setq-default mode-line-buffer-identification '(" %b"))
a1506d29 1054
e36a387d
MK
1055 ;; setup emacs-supported vi-style feel
1056 (setq next-line-add-newlines nil
1057 require-final-newline t)
a1506d29 1058
e36a387d 1059 ;; don't bark when mark is inactive
e83d1fe8 1060 (if (featurep 'emacs)
5489c3d3 1061 (setq mark-even-if-inactive t))
a1506d29 1062
e36a387d 1063 (setq scroll-step 1)
a1506d29 1064
e36a387d 1065 ;; Variable displaying the current Viper state in the mode line.
8626cfa2 1066 (or (memq 'viper-mode-string global-mode-string)
e36a387d 1067 (setq global-mode-string
8626cfa2 1068 (append '("" viper-mode-string) (cdr global-mode-string))))
e36a387d 1069
0e52cd13 1070 (if (featurep 'xemacs)
2ee00512
MK
1071 ;; XEmacs
1072 (defadvice describe-key (before viper-describe-key-ad protect activate)
1073 "Force to read key via `viper-read-key-sequence'."
1074 (interactive (list (viper-read-key-sequence "Describe key: "))))
1075 ;; Emacs
1076 (defadvice describe-key (before viper-describe-key-ad protect activate)
1077 "Force to read key via `viper-read-key-sequence'."
1078 (interactive (let (key)
1079 (setq key (viper-read-key-sequence
1080 "Describe key (or click or menu item): "))
1081 (list key
1082 (prefix-numeric-value current-prefix-arg)
1083 ;; If KEY is a down-event, read also the
1084 ;; corresponding up-event.
1085 (and (vectorp key)
1086 (let ((last-idx (1- (length key))))
1087 (and (eventp (aref key last-idx))
1088 (memq 'down (event-modifiers
1089 (aref key last-idx)))))
1090 (or (and (eventp (aref key 0))
1091 (memq 'down (event-modifiers
1092 (aref key 0)))
1093 ;; For the C-down-mouse-2 popup menu,
1094 ;; there is no subsequent up-event
1095 (= (length key) 1))
1096 (and (> (length key) 1)
1097 (eventp (aref key 1))
1098 (memq 'down (event-modifiers (aref key 1)))))
1099 (read-event))))))
1100 ) ; (if (featurep 'xemacs)
53964682 1101
0e52cd13 1102 (if (featurep 'xemacs)
2ee00512
MK
1103 ;; XEmacs
1104 (defadvice describe-key-briefly
1105 (before viper-describe-key-briefly-ad protect activate)
1106 "Force to read key via `viper-read-key-sequence'."
1107 (interactive (list (viper-read-key-sequence "Describe key briefly: "))))
1108 ;; Emacs
1109 (defadvice describe-key-briefly
1110 (before viper-describe-key-briefly-ad protect activate)
1111 "Force to read key via `viper-read-key-sequence'."
1112 (interactive (let (key)
1113 (setq key (viper-read-key-sequence
1114 "Describe key (or click or menu item): "))
1115 ;; If KEY is a down-event, read and discard the
1116 ;; corresponding up-event.
1117 (and (vectorp key)
1118 (let ((last-idx (1- (length key))))
1119 (and (eventp (aref key last-idx))
1120 (memq 'down (event-modifiers (aref key last-idx)))))
1121 (read-event))
1122 (list key
1123 (if current-prefix-arg
1124 (prefix-numeric-value current-prefix-arg))
1125 1))))
1126 ) ; (if (featurep 'xemacs)
53964682 1127
8626cfa2 1128 (defadvice find-file (before viper-add-suffix-advice activate)
e36a387d
MK
1129 "Use `read-file-name' for reading arguments."
1130 (interactive (cons (read-file-name "Find file: " nil default-directory)
560ef11a 1131 ;; XEmacs: if Mule & prefix arg, ask for coding system
e83d1fe8 1132 (cond ((and (featurep 'xemacs) (featurep 'mule))
1e70790f
MK
1133 (list
1134 (and current-prefix-arg
560ef11a
MK
1135 (read-coding-system "Coding-system: "))))
1136 ;; Emacs: do wildcards
e83d1fe8 1137 ((and (featurep 'emacs) (boundp 'find-file-wildcards))
560ef11a
MK
1138 (list find-file-wildcards))))
1139 ))
a1506d29 1140
8626cfa2 1141 (defadvice find-file-other-window (before viper-add-suffix-advice activate)
e36a387d
MK
1142 "Use `read-file-name' for reading arguments."
1143 (interactive (cons (read-file-name "Find file in other window: "
1144 nil default-directory)
560ef11a 1145 ;; XEmacs: if Mule & prefix arg, ask for coding system
e83d1fe8 1146 (cond ((and (featurep 'xemacs) (featurep 'mule))
1e70790f
MK
1147 (list
1148 (and current-prefix-arg
560ef11a
MK
1149 (read-coding-system "Coding-system: "))))
1150 ;; Emacs: do wildcards
e83d1fe8 1151 ((and (featurep 'emacs) (boundp 'find-file-wildcards))
560ef11a
MK
1152 (list find-file-wildcards))))
1153 ))
a1506d29 1154
1e70790f 1155
8626cfa2 1156 (defadvice find-file-other-frame (before viper-add-suffix-advice activate)
e36a387d
MK
1157 "Use `read-file-name' for reading arguments."
1158 (interactive (cons (read-file-name "Find file in other frame: "
1159 nil default-directory)
560ef11a 1160 ;; XEmacs: if Mule & prefix arg, ask for coding system
e83d1fe8 1161 (cond ((and (featurep 'xemacs) (featurep 'mule))
1e70790f
MK
1162 (list
1163 (and current-prefix-arg
560ef11a
MK
1164 (read-coding-system "Coding-system: "))))
1165 ;; Emacs: do wildcards
e83d1fe8 1166 ((and (featurep 'emacs) (boundp 'find-file-wildcards))
560ef11a
MK
1167 (list find-file-wildcards))))
1168 ))
1e70790f 1169
a1506d29 1170
8626cfa2
MK
1171 (defadvice read-file-name (around viper-suffix-advice activate)
1172 "Tell `exit-minibuffer' to run `viper-file-add-suffix' as a hook."
96dffd25 1173 (let ((viper-minibuffer-exit-hook
2eb4bdca
MK
1174 (append viper-minibuffer-exit-hook
1175 '(viper-minibuffer-trim-tail viper-file-add-suffix))))
e36a387d 1176 ad-do-it))
a1506d29 1177
8626cfa2 1178 (defadvice start-kbd-macro (after viper-kbd-advice activate)
e36a387d
MK
1179 "Remove Viper's intercepting bindings for C-x ).
1180 This may be needed if the previous `:map' command terminated abnormally."
8626cfa2
MK
1181 (define-key viper-vi-intercept-map "\C-x)" nil)
1182 (define-key viper-insert-intercept-map "\C-x)" nil)
1183 (define-key viper-emacs-intercept-map "\C-x)" nil))
41497c90 1184
8ea74b0e
MK
1185 (defadvice add-minor-mode (after
1186 viper-advice-add-minor-mode
1187 (toggle name &optional keymap after toggle-fun)
1188 activate)
38685583
MK
1189 "Run viper-normalize-minor-mode-map-alist after adding a minor mode."
1190 (viper-normalize-minor-mode-map-alist)
1191 (unless
1192 (and (fboundp 'add-to-ordered-list) (boundp 'emulation-mode-map-alists))
1193 (setq-default minor-mode-map-alist minor-mode-map-alist)))
8ea74b0e 1194
41497c90
MK
1195 ;; catch frame switching event
1196 (if (viper-window-display-p)
e83d1fe8 1197 (if (featurep 'xemacs)
41497c90
MK
1198 (add-hook 'mouse-leave-frame-hook
1199 'viper-remember-current-frame)
1200 (defadvice handle-switch-frame (before viper-frame-advice activate)
a1506d29 1201 "Remember the selected frame before the switch-frame event."
41497c90
MK
1202 (viper-remember-current-frame (selected-frame)))) )
1203
8626cfa2 1204 ) ; end viper-non-hook-settings
e36a387d 1205
4960e757 1206
726e270f 1207\f
41497c90
MK
1208;; Ask only if this-command/last-command are nil, i.e., when loading
1209(cond ((and (eq viper-mode 'ask) (null this-command) (null last-command))
1210 (save-window-excursion
1211 (with-output-to-temp-buffer " *viper-info*"
1212 (princ "
cbd9191d 1213You have loaded Viper, and are about to Viperize your Emacs!
e36a387d 1214
8626cfa2 1215Viper is a Package for Emacs Rebels and a venomous VI PERil,
e36a387d
MK
1216
1217It's time to decide: to Viperize or not to Viperize...
1218
a1506d29 1219If you wish to Viperize AND make this your way of life, please put
e36a387d
MK
1220
1221 (setq viper-mode t)
1222 (require 'viper)
1223
865fe16f 1224in your init file (preferably, close to the top).
e36a387d
MK
1225These two lines must come in the order given.
1226
8626cfa2
MK
1227** Viper users:
1228 **** The startup file name has been changed from .vip to .viper
1229 **** All vip-* style names have been converted to viper-* style."))
41497c90
MK
1230 (if (y-or-n-p "Viperize? ")
1231 (setq viper-mode t)
1232 (setq viper-mode nil))
1233 (message "")
1234 (kill-buffer " *viper-info*")))
1235
3af0304a 1236 ;; If viper-mode is t, then just continue. Viper will kick in.
41497c90 1237 ((eq viper-mode t))
2eb4bdca 1238 ;; Otherwise, it was asking Viper was not loaded through .emacs
41497c90 1239 ;; In this case, it was either through M-x viper-mode or via something
a1506d29 1240 ;; else, like the custom widget. If Viper was loaded through
41497c90
MK
1241 ;; M-x viper-mode, then viper will kick in anyway.
1242 (t (setq viper-mode nil)))
8626cfa2
MK
1243
1244(defun viper-load-custom-file ()
1245 (if (and (file-exists-p viper-custom-file-name)
1246 (not noninteractive))
1247 (load viper-custom-file-name)))
e36a387d 1248
726e270f
MK
1249
1250
1251\f
1e70790f
MK
1252
1253
1254;; save non-viper vars that Viper might change
1255(if (null viper-saved-non-viper-variables)
1256 (setq viper-saved-non-viper-variables
1257 (list
14acf2f5 1258 (cons 'default-major-mode (list (default-value 'major-mode)))
1e70790f
MK
1259 (cons 'next-line-add-newlines (list next-line-add-newlines))
1260 (cons 'require-final-newline (list require-final-newline))
1e70790f
MK
1261 (cons 'scroll-step (list scroll-step))
1262 (cons 'mode-line-buffer-identification
1263 (list (default-value 'mode-line-buffer-identification)))
1264 (cons 'global-mode-string (list global-mode-string))
e83d1fe8 1265 (if (featurep 'emacs)
5489c3d3 1266 (cons 'mark-even-if-inactive (list mark-even-if-inactive)))
1e70790f 1267 )))
a1506d29
JB
1268
1269
e36a387d 1270;; Set some useful macros, advices
a1506d29 1271;; These must be BEFORE ~/.viper is loaded,
1e70790f 1272;; so the user can unrecord them in ~/.viper.
e36a387d
MK
1273(if viper-mode
1274 (progn
1275 ;; set advices and some variables that give emacs Vi look.
8626cfa2 1276 (viper-non-hook-settings)
e36a387d
MK
1277
1278 ;; repeat the 2nd previous command without rotating the command history
8626cfa2
MK
1279 (viper-record-kbd-macro
1280 (vector viper-repeat-from-history-key '\1) 'vi-state
1281 [(meta x) v i p e r - r e p e a t - f r o m - h i s t o r y return] 't)
e36a387d 1282 ;; repeat the 3d previous command without rotating the command history
8626cfa2
MK
1283 (viper-record-kbd-macro
1284 (vector viper-repeat-from-history-key '\2) 'vi-state
1285 [(meta x) v i p e r - r e p e a t - f r o m - h i s t o r y return] 't)
a1506d29
JB
1286
1287 ;; set macros for toggling case sensitivity and regexp search
8626cfa2 1288 (viper-set-searchstyle-toggling-macros nil)
e36a387d 1289 ;; Make %%% toggle parsing comments for matching parentheses
8626cfa2
MK
1290 (viper-set-parsing-style-toggling-macro nil)
1291
1292 ;; ~/.viper is loaded if exists
1293 (viper-load-custom-file)
a1506d29 1294
8626cfa2
MK
1295 ;; should be after loading custom file to avoid the pesky msg that
1296 ;; mouse-search/insert keys are already bound
1297 (viper-bind-mouse-search-key)
1298 (viper-bind-mouse-insert-key)
e36a387d 1299 ))
a1506d29 1300
6c2e12f4 1301
6c2e12f4 1302\f
8626cfa2 1303;; Applying Viper customization -- runs after (load .viper)
6c2e12f4 1304
8971f87b 1305;; Save user settings or Viper defaults for vars controlled by
a1506d29 1306;; viper-expert-level
1e70790f 1307(if (null viper-saved-user-settings)
a1506d29 1308 (setq viper-saved-user-settings
8626cfa2 1309 (list (cons 'viper-want-ctl-h-help (list viper-want-ctl-h-help))
1e70790f 1310 (cons 'viper-always (list viper-always))
8626cfa2
MK
1311 (cons 'viper-no-multiple-ESC (list viper-no-multiple-ESC))
1312 (cons 'viper-ex-style-motion (list viper-ex-style-motion))
34317da2
MK
1313 (cons 'viper-ex-style-editing
1314 (list viper-ex-style-editing))
a1506d29 1315 (cons 'viper-want-emacs-keys-in-vi
8626cfa2
MK
1316 (list viper-want-emacs-keys-in-vi))
1317 (cons 'viper-electric-mode (list viper-electric-mode))
1318 (cons 'viper-want-emacs-keys-in-insert
1319 (list viper-want-emacs-keys-in-insert))
1320 (cons 'viper-re-search (list viper-re-search)))))
a1506d29 1321
6c2e12f4 1322
e36a387d
MK
1323(if viper-mode
1324 (progn
8626cfa2
MK
1325 (viper-set-minibuffer-style)
1326 (if viper-buffer-search-char
1327 (viper-buffer-search-enable))
34317da2 1328 (viper-update-syntax-classes 'set-default)
e36a387d 1329 ))
a1506d29 1330
d5e52f99 1331\f
6c2e12f4 1332;;; Familiarize Viper with some minor modes that have their own keymaps
e36a387d
MK
1333(if viper-mode
1334 (progn
8626cfa2
MK
1335 (viper-harness-minor-mode "compile")
1336 (viper-harness-minor-mode "outline")
1337 (viper-harness-minor-mode "allout")
1338 (viper-harness-minor-mode "xref")
1339 (viper-harness-minor-mode "lmenu")
1340 (viper-harness-minor-mode "vc")
1341 (viper-harness-minor-mode "ltx-math") ; LaTeX-math-mode in AUC-TeX, which
1342 (viper-harness-minor-mode "latex") ; sits in one of these two files
1343 (viper-harness-minor-mode "cyrillic")
1344 (viper-harness-minor-mode "russian")
1345 (viper-harness-minor-mode "view-less")
1346 (viper-harness-minor-mode "view")
2eb4bdca 1347 (viper-harness-minor-mode "reftex")
3af0304a 1348 (viper-harness-minor-mode "flyspell")
e36a387d 1349 ))
6c2e12f4
KH
1350
1351
1352;; Intercept maps could go in viper-keym.el
1e70790f 1353;; We keep them here in case someone redefines them in ~/.viper
6c2e12f4 1354
8626cfa2
MK
1355(define-key viper-vi-intercept-map viper-ESC-key 'viper-intercept-ESC-key)
1356(define-key viper-insert-intercept-map viper-ESC-key 'viper-intercept-ESC-key)
6c2e12f4 1357
8626cfa2
MK
1358;; This is taken care of by viper-insert-global-user-map.
1359;;(define-key viper-replace-map viper-ESC-key 'viper-intercept-ESC-key)
6c2e12f4 1360
34da0a2b 1361
8626cfa2 1362;; The default viper-toggle-key is \C-z; for the novice, it suspends or
6c2e12f4 1363;; iconifies Emacs
8626cfa2
MK
1364(define-key viper-vi-intercept-map viper-toggle-key 'viper-toggle-key-action)
1365(define-key
1366 viper-emacs-intercept-map viper-toggle-key 'viper-change-state-to-vi)
a1506d29 1367
38685583 1368;;; Removed to avoid bad interaction with cua-mode.
328b4b70 1369;;; Escape from Emacs and Insert modes to Vi for one command
38685583
MK
1370;;(define-key viper-emacs-intercept-map "\C-c\\" 'viper-escape-to-vi)
1371;;(define-key viper-insert-intercept-map "\C-c\\" 'viper-escape-to-vi)
328b4b70
MK
1372
1373(if viper-mode
c004db97
MK
1374 (setq-default viper-emacs-intercept-minor-mode t
1375 viper-emacs-local-user-minor-mode t
1376 viper-emacs-global-user-minor-mode t
1377 viper-emacs-kbd-minor-mode t
1378 viper-emacs-state-modifier-minor-mode t))
1379(if (and viper-mode (eq viper-current-state 'emacs-state))
1380 (setq viper-emacs-intercept-minor-mode t
1381 viper-emacs-local-user-minor-mode t
1382 viper-emacs-global-user-minor-mode t
1383 viper-emacs-kbd-minor-mode t
1384 viper-emacs-state-modifier-minor-mode t))
6c2e12f4
KH
1385
1386
e36a387d 1387(if (and viper-mode
a1506d29 1388 (or viper-always
1e70790f 1389 (and (< viper-expert-level 5) (> viper-expert-level 0))))
8626cfa2 1390 (viper-set-hooks))
a1506d29 1391
2550055a
MK
1392;; Let all minor modes take effect after loading.
1393;; This may not be enough, so we also set default minor-mode-alist.
6c2e12f4 1394;; Without setting the default, new buffers that come up in emacs mode have
8626cfa2 1395;; minor-mode-map-alist = nil, unless we call viper-change-state-*
328b4b70 1396(if (and viper-mode (eq viper-current-state 'emacs-state))
6c2e12f4 1397 (progn
8626cfa2 1398 (viper-change-state-to-emacs)
38685583
MK
1399 (unless
1400 (and (fboundp 'add-to-ordered-list)
1401 (boundp 'emulation-mode-map-alists))
1402 (setq-default minor-mode-map-alist minor-mode-map-alist))
6c2e12f4 1403 ))
2eb4bdca 1404
4960e757 1405(if (and viper-mode (this-major-mode-requires-vi-state major-mode))
2eb4bdca 1406 (viper-mode))
6c2e12f4 1407
2550055a
MK
1408(if viper-mode
1409 (setq initial-major-mode
1410 `(lambda ()
1411 (funcall (quote ,initial-major-mode))
1412 (set-viper-state-in-major-mode))
1413 ))
1414
1415
d5e52f99 1416
8626cfa2 1417(run-hooks 'viper-load-hook) ; the last chance to change something
6c2e12f4 1418
d5e52f99 1419(provide 'viper)
6c2e12f4 1420
1e70790f 1421
e2de3a29
MK
1422;; Local Variables:
1423;; eval: (put 'viper-deflocalvar 'lisp-indent-hook 'defun)
1424;; End:
1e70790f 1425
60370d40 1426;;; viper.el ends here