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