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