1 ;;; viper-macs.el --- functions implementing keyboard macros for Viper
3 ;; Copyright (C) 1994-1997, 2000-2013 Free Software Foundation, Inc.
5 ;; Author: Michael Kifer <kifer@cs.stonybrook.edu>
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
30 (defvar viper-ex-work-buf)
31 (defvar viper-custom-file-name)
32 (defvar viper-current-state)
33 (defvar viper-fast-keyseq-timeout)
44 ;; Register holding last macro.
45 (defvar viper-last-macro-reg nil)
47 ;; format of the elements of kbd alists:
48 ;; (name ((buf . macr)...(buf . macr)) ((maj-mode . macr)...) (t . macr))
49 ;; kbd macro alist for Vi state
50 (defvar viper-vi-kbd-macro-alist nil)
51 ;; same for insert/replace state
52 (defvar viper-insert-kbd-macro-alist nil)
53 ;; same for emacs state
54 (defvar viper-emacs-kbd-macro-alist nil)
56 ;; Internal var that passes info between start-kbd-macro and end-kbd-macro
58 (defvar viper-kbd-macro-parameters nil)
60 (defvar viper-this-kbd-macro nil
61 "Vector of keys representing the name of currently running Viper kbd macro.")
62 (defvar viper-last-kbd-macro nil
63 "Vector of keys representing the name of last Viper keyboard macro.")
65 (defcustom viper-repeat-from-history-key 'f12
66 "Prefix key for accessing previously typed Vi commands.
68 The previous command is accessible, as usual, via `.'. The command before this
69 can be invoked as `<this key> 1', and the command before that, and the command
70 before that one is accessible as `<this key> 2'.
71 The notation for these keys is borrowed from XEmacs. Basically,
72 a key is a symbol, e.g., `a', `\\1', `f2', etc., or a list, e.g.,
81 (declare-function viper-change-state-to-insert "viper-cmd" ())
86 macro-name macro-body map-args ins)
87 (save-window-excursion
88 (set-buffer viper-ex-work-buf)
94 (setq map-args (ex-map-read-args mod-char)
95 macro-name (car map-args)
96 macro-body (cdr map-args))
97 (setq viper-kbd-macro-parameters (list ins mod-char macro-name macro-body))
99 (viper-end-mapping-kbd-macro 'ignore)
100 (ex-fixup-history (format "map%s %S" mod-char
101 (viper-display-macro macro-name)))
102 ;; if defining macro for insert, switch there for authentic WYSIWYG
103 (if ins (viper-change-state-to-insert))
104 (start-kbd-macro nil)
105 (define-key viper-vi-intercept-map "\C-x)" 'viper-end-mapping-kbd-macro)
106 (define-key viper-insert-intercept-map "\C-x)" 'viper-end-mapping-kbd-macro)
107 (define-key viper-emacs-intercept-map "\C-x)" 'viper-end-mapping-kbd-macro)
108 (message "Mapping %S in %s state. Type macro definition followed by `C-x )'"
109 (viper-display-macro macro-name)
110 (if ins "Insert" "Vi")))
118 (save-window-excursion
119 (set-buffer viper-ex-work-buf)
126 (setq macro-name (ex-unmap-read-args mod-char))
127 (setq temp (viper-fixup-macro (vconcat macro-name))) ;; copy and fixup
128 (ex-fixup-history (format "unmap%s %S" mod-char
129 (viper-display-macro temp)))
130 (viper-unrecord-kbd-macro macro-name (if ins 'insert-state 'vi-state))
134 ;; read arguments for ex-map
135 (defun ex-map-read-args (variant)
136 (let ((cursor-in-echo-area t)
138 temp key event message
139 macro-name macro-body args)
142 (setq args (concat (ex-get-inline-cmd-args ".*map[!]*[ \t]?" "\n\C-m")
144 temp (read-from-string args)
145 macro-name (car temp)
146 macro-body (car (read-from-string args (cdr temp))))
150 '("map: Macro name and body must be a quoted string or a vector"))))
152 ;; We expect macro-name to be a vector, a string, or a quoted string.
153 ;; In the second case, it will emerge as a symbol when read from
154 ;; the above read-from-string. So we need to convert it into a string
156 (cond ((vectorp macro-name) nil)
157 ((stringp macro-name)
158 (setq macro-name (vconcat macro-name)))
159 (t (setq macro-name (vconcat (prin1-to-string macro-name)))))
160 (message ":map%s <Macro Name>" variant)(sit-for 2)
163 '(?\C-m ?\n (control m) (control j) return linefeed)))
164 (setq key-seq (vconcat key-seq (if key (vector key) [])))
165 ;; the only keys available for editing are these-- no help while there
168 '(?\b ?\d '^? '^H (control h) (control \?) backspace delete))
169 (setq key-seq (viper-subseq key-seq 0 (- (length key-seq) 2))))
173 variant (if (> (length key-seq) 0)
174 (prin1-to-string (viper-display-macro key-seq))
176 (message "%s" message)
177 (setq event (viper-read-key))
178 ;;(setq event (viper-read-event))
180 (if (viper-mouse-event-p event)
182 (message "%s (No mouse---only keyboard keys, please)"
186 (viper-event-key event)))
188 (setq macro-name key-seq))
190 (if (= (length macro-name) 0)
191 (error "Can't map an empty macro name"))
192 (setq macro-name (viper-fixup-macro macro-name))
193 (if (viper-char-array-p macro-name)
194 (setq macro-name (viper-char-array-to-macro macro-name)))
197 (cond ((viper-char-array-p macro-body)
198 (setq macro-body (viper-char-array-to-macro macro-body)))
199 ((vectorp macro-body) nil)
200 (t (error "map: Invalid syntax in macro definition"))))
201 (setq cursor-in-echo-area nil)(sit-for 0) ; this overcomes xemacs tty bug
202 (cons macro-name macro-body)))
206 ;; read arguments for ex-unmap
207 (defun ex-unmap-read-args (variant)
208 (let ((cursor-in-echo-area t)
209 (macro-alist (if (string= variant "!")
210 viper-insert-kbd-macro-alist
211 viper-vi-kbd-macro-alist))
212 ;; these are disabled just in case, to avoid surprises when doing
214 viper-vi-kbd-minor-mode viper-insert-kbd-minor-mode
215 viper-emacs-kbd-minor-mode
216 viper-vi-intercept-minor-mode viper-insert-intercept-minor-mode
217 viper-emacs-intercept-minor-mode
219 key key-seq macro-name)
220 (setq macro-name (ex-get-inline-cmd-args ".*unma?p?[!]*[ \t]*"))
222 (if (> (length macro-name) 0)
224 (message ":unmap%s <Name>" variant) (sit-for 2)
227 (member key '(?\C-m ?\n (control m) (control j) return linefeed)))
228 (setq key-seq (vconcat key-seq (if key (vector key) [])))
229 ;; the only keys available for editing are these-- no help while there
232 '(?\b ?\d '^? '^H (control h) (control \?) backspace delete))
233 (setq key-seq (viper-subseq key-seq 0 (- (length key-seq) 2))))
234 ((member key '(tab (control i) ?\t))
235 (setq key-seq (viper-subseq key-seq 0 (1- (length key-seq))))
239 variant (if (> (length key-seq) 0)
241 (viper-display-macro key-seq))
244 (viper-do-sequence-completion key-seq macro-alist message))
249 variant (if (> (length key-seq) 0)
251 (viper-display-macro key-seq))
253 (message "%s" message)
254 (setq event (viper-read-key))
255 ;;(setq event (viper-read-event))
257 (if (viper-mouse-event-p event)
259 (message "%s (No mouse---only keyboard keys, please)"
263 (viper-event-key event)))
265 (setq macro-name key-seq))
267 (if (= (length macro-name) 0)
268 (error "Can't unmap an empty macro name"))
270 ;; convert macro names into vector, if starts with a `['
271 (if (memq (elt macro-name 0) '(?\[ ?\"))
272 (car (read-from-string macro-name))
273 (vconcat macro-name))
277 (declare-function viper-change-state-to-vi "viper-cmd" ())
279 ;; Terminate a Vi kbd macro.
280 ;; optional argument IGNORE, if t, indicates that we are dealing with an
281 ;; existing macro that needs to be registered, but there is no need to
282 ;; terminate a kbd macro.
283 (defun viper-end-mapping-kbd-macro (&optional ignore)
285 (define-key viper-vi-intercept-map "\C-x)" nil)
286 (define-key viper-insert-intercept-map "\C-x)" nil)
287 (define-key viper-emacs-intercept-map "\C-x)" nil)
288 (if (and (not ignore)
289 (or (not viper-kbd-macro-parameters)
290 (not defining-kbd-macro)))
291 (error "Not mapping a kbd-macro"))
292 (let ((mod-char (nth 1 viper-kbd-macro-parameters))
293 (ins (nth 0 viper-kbd-macro-parameters))
294 (macro-name (nth 2 viper-kbd-macro-parameters))
295 (macro-body (nth 3 viper-kbd-macro-parameters)))
296 (setq viper-kbd-macro-parameters nil)
300 (setq macro-body (viper-events-to-macro last-kbd-macro))
301 ;; always go back to Vi, since this is where we started
303 (viper-change-state-to-vi)))
305 (viper-record-kbd-macro macro-name
306 (if ins 'insert-state 'vi-state)
307 (viper-display-macro macro-body))
309 (ex-fixup-history (format "map%s %S %S" mod-char
310 (viper-display-macro macro-name)
311 (viper-display-macro macro-body)))
317 ;;; Recording, unrecording, executing
319 ;; Accepts as macro names: strings and vectors.
320 ;; strings must be strings of characters; vectors must be vectors of keys
321 ;; in canonical form, which is essentially the form used in XEmacs.
322 ;; More general definitions are inherited by more specific scopes:
323 ;; global->major mode->buffer. More specific definitions override more general
324 (defun viper-record-kbd-macro (macro-name state macro-body &optional scope)
325 "Record a Vi macro. Can be used in `.viper' file to define permanent macros.
326 MACRO-NAME is a string of characters or a vector of keys. STATE is
327 either `vi-state' or `insert-state'. It specifies the Viper state in which to
328 define the macro. MACRO-BODY is a string that represents the keyboard macro.
329 Optional SCOPE says whether the macro should be global \(t\), mode-specific
330 \(a major-mode symbol\), or buffer-specific \(buffer name, a string\).
331 If SCOPE is nil, the user is asked to specify the scope."
332 (let* (state-name keymap
334 (cond ((eq state 'vi-state)
335 (setq state-name "Vi state"
336 keymap viper-vi-kbd-map)
337 'viper-vi-kbd-macro-alist)
338 ((memq state '(insert-state replace-state))
339 (setq state-name "Insert state"
340 keymap viper-insert-kbd-map)
341 'viper-insert-kbd-macro-alist)
343 (setq state-name "Emacs state"
344 keymap viper-emacs-kbd-map)
345 'viper-emacs-kbd-macro-alist)
347 new-elt old-elt old-sub-elt msg
350 (if (= (length macro-name) 0)
351 (error "Can't map an empty macro name"))
353 ;; Macro-name is usually a vector. However, command history or macros
354 ;; recorded in ~/.viper may be recorded as strings. So, convert to
356 (setq macro-name (viper-fixup-macro macro-name))
357 (if (viper-char-array-p macro-name)
358 (setq macro-name (viper-char-array-to-macro macro-name)))
359 (setq macro-body (viper-fixup-macro macro-body))
360 (if (viper-char-array-p macro-body)
361 (setq macro-body (viper-char-array-to-macro macro-body)))
363 ;; don't ask if scope is given and is of the right type
366 (and scope (symbolp scope))
372 "Map this macro for buffer `%s' only? "
376 "%S is mapped to %s for %s in `%s'"
377 (viper-display-macro macro-name)
378 (viper-abbreviate-string
381 (setq temp (viper-display-macro macro-body)))
383 (if (stringp temp) " ....\"" " ....]"))
384 state-name (buffer-name)))
388 "Map this macro for the major mode `%S' only? "
392 "%S is mapped to %s for %s in `%S'"
393 (viper-display-macro macro-name)
394 (viper-abbreviate-string
397 (setq temp (viper-display-macro macro-body)))
399 (if (stringp macro-body) " ....\"" " ....]"))
400 state-name major-mode))
405 "%S is globally mapped to %s in %s"
406 (viper-display-macro macro-name)
407 (viper-abbreviate-string
410 (setq temp (viper-display-macro macro-body)))
412 (if (stringp macro-body) " ....\"" " ....]"))
416 (format "Save this macro in %s? "
417 (viper-abbreviate-file-name viper-custom-file-name)))
418 (viper-save-string-in-file
419 (format "\n(viper-record-kbd-macro %S '%S %s '%S)"
420 (viper-display-macro macro-name)
422 ;; if we don't let vector macro-body through %S,
423 ;; the symbols `\.' `\[' etc will be converted into
424 ;; characters, causing invalid read error on recorded
426 ;; I am not sure is macro-body can still be a string at
427 ;; this point, but I am preserving this option anyway.
428 (if (vectorp macro-body)
429 (format "%S" macro-body)
432 viper-custom-file-name))
439 (cond ((eq scope t) (list nil nil (cons t nil)))
441 (list nil (list (cons scope nil)) (cons t nil)))
443 (list (list (cons scope nil)) nil (cons t nil))))))
444 (setq old-elt (assoc macro-name (eval macro-alist-var)))
448 ;; insert new-elt in macro-alist-var and keep the list sorted
451 (vector (viper-key-to-emacs-key (aref macro-name 0)))
452 'viper-exec-mapped-kbd-macro)
453 (setq lis (eval macro-alist-var))
454 (while (and lis (string< (viper-array-to-string (car (car lis)))
455 (viper-array-to-string macro-name)))
456 (setq lis2 (cons (car lis) lis2))
457 (setq lis (cdr lis)))
459 (setq lis2 (reverse lis2))
460 (set macro-alist-var (append lis2 (cons new-elt lis)))
461 (setq old-elt new-elt)))
463 (cond ((eq scope t) (viper-kbd-global-pair old-elt))
464 ((symbolp scope) (assoc scope (viper-kbd-mode-alist old-elt)))
465 ((stringp scope) (assoc scope (viper-kbd-buf-alist old-elt)))))
467 (setcdr old-sub-elt macro-body)
468 (cond ((symbolp scope) (setcar (cdr (cdr old-elt))
469 (cons (cons scope macro-body)
470 (viper-kbd-mode-alist old-elt))))
471 ((stringp scope) (setcar (cdr old-elt)
472 (cons (cons scope macro-body)
473 (viper-kbd-buf-alist old-elt))))))
478 ;; macro name must be a vector of viper-style keys
479 ;; viper-unrecord-kbd-macro doesn't have scope. Macro definitions are inherited
480 ;; from global -> major mode -> buffer
481 ;; More specific definition overrides more general
482 ;; Can't unrecord definition for more specific, if a more general definition is
484 (defun viper-unrecord-kbd-macro (macro-name state)
485 "Delete macro MACRO-NAME from Viper STATE.
486 MACRO-NAME must be a vector of viper-style keys. This command is used by Viper
487 internally, but the user can also use it in ~/.viper to delete pre-defined
488 macros supplied with Viper. The best way to avoid mistakes in macro names to
489 be passed to this function is to use viper-describe-kbd-macros and copy the
491 (let* (state-name keymap
493 (cond ((eq state 'vi-state)
494 (setq state-name "Vi state"
495 keymap viper-vi-kbd-map)
496 'viper-vi-kbd-macro-alist)
497 ((memq state '(insert-state replace-state))
498 (setq state-name "Insert state"
499 keymap viper-insert-kbd-map)
500 'viper-insert-kbd-macro-alist)
502 (setq state-name "Emacs state"
503 keymap viper-emacs-kbd-map)
504 'viper-emacs-kbd-macro-alist)
506 buf-mapping mode-mapping global-mapping
507 macro-pair macro-entry)
509 ;; Macro-name is usually a vector. However, command history or macros
510 ;; recorded in ~/.viper may appear as strings. So, convert to vectors.
511 (setq macro-name (viper-fixup-macro macro-name))
512 (if (viper-char-array-p macro-name)
513 (setq macro-name (viper-char-array-to-macro macro-name)))
515 (setq macro-entry (assoc macro-name (eval macro-alist-var)))
516 (if (= (length macro-name) 0)
517 (error "Can't unmap an empty macro name"))
518 (if (null macro-entry)
519 (error "%S is not mapped to a macro for %s in `%s'"
520 (viper-display-macro macro-name)
521 state-name (buffer-name)))
523 (setq buf-mapping (viper-kbd-buf-pair macro-entry)
524 mode-mapping (viper-kbd-mode-pair macro-entry)
525 global-mapping (viper-kbd-global-pair macro-entry))
527 (cond ((and (cdr buf-mapping)
528 (or (and (not (cdr mode-mapping)) (not (cdr global-mapping)))
530 (format "Unmap %S for `%s' only? "
531 (viper-display-macro macro-name)
533 (setq macro-pair buf-mapping)
534 (message "%S is unmapped for %s in `%s'"
535 (viper-display-macro macro-name)
536 state-name (buffer-name)))
537 ((and (cdr mode-mapping)
538 (or (not (cdr global-mapping))
540 (format "Unmap %S for the major mode `%S' only? "
541 (viper-display-macro macro-name)
543 (setq macro-pair mode-mapping)
544 (message "%S is unmapped for %s in %S"
545 (viper-display-macro macro-name) state-name major-mode))
546 ((cdr (setq macro-pair global-mapping))
548 "Global mapping for %S in %s is removed"
549 (viper-display-macro macro-name) state-name))
550 (t (error "%S is not mapped to a macro for %s in `%s'"
551 (viper-display-macro macro-name)
552 state-name (buffer-name))))
553 (setcdr macro-pair nil)
554 (or (cdr buf-mapping)
558 (set macro-alist-var (delq macro-entry (eval macro-alist-var)))
559 (if (viper-can-release-key (aref macro-name 0)
560 (eval macro-alist-var))
563 (vector (viper-key-to-emacs-key (aref macro-name 0)))
568 ;; Check if MACRO-ALIST has an entry for a macro name starting with
569 ;; CHAR. If not, this indicates that the binding for this char
570 ;; in viper-vi/insert-kbd-map can be released.
571 (defun viper-can-release-key (char macro-alist)
572 (let ((lis macro-alist)
576 (while (and lis can-release)
577 (setq macro-name (car (car lis)))
578 (if (eq char (aref macro-name 0))
579 (setq can-release nil))
580 (setq lis (cdr lis)))
584 (defun viper-exec-mapped-kbd-macro (count)
585 "Dispatch kbd macro."
587 (let* ((macro-alist (cond ((eq viper-current-state 'vi-state)
588 viper-vi-kbd-macro-alist)
589 ((memq viper-current-state
590 '(insert-state replace-state))
591 viper-insert-kbd-macro-alist)
593 viper-emacs-kbd-macro-alist)))
594 (unmatched-suffix "")
595 ;; Macros and keys are executed with other macros turned off
596 ;; For macros, this is done to avoid macro recursion
597 viper-vi-kbd-minor-mode viper-insert-kbd-minor-mode
598 viper-emacs-kbd-minor-mode
599 next-best-match keyseq event-seq
600 macro-first-char macro-alist-elt macro-body
603 (setq macro-first-char last-command-event
604 event-seq (viper-read-fast-keysequence macro-first-char macro-alist)
605 keyseq (viper-events-to-macro event-seq)
606 macro-alist-elt (assoc keyseq macro-alist)
607 next-best-match (viper-find-best-matching-macro macro-alist keyseq))
609 (if (null macro-alist-elt)
610 (setq macro-alist-elt (car next-best-match)
611 unmatched-suffix (viper-subseq event-seq (cdr next-best-match))))
613 (cond ((null macro-alist-elt))
614 ((setq macro-body (viper-kbd-buf-definition macro-alist-elt)))
615 ((setq macro-body (viper-kbd-mode-definition macro-alist-elt)))
616 ((setq macro-body (viper-kbd-global-definition macro-alist-elt))))
618 ;; when defining keyboard macro, don't use the macro mappings
619 (if (and macro-body (not defining-kbd-macro))
620 ;; block cmd executed as part of a macro from entering command history
621 (let ((command-history command-history))
622 (setq viper-this-kbd-macro (car macro-alist-elt))
623 (execute-kbd-macro (viper-macro-to-events macro-body) count)
624 (setq viper-this-kbd-macro nil
625 viper-last-kbd-macro (car macro-alist-elt))
626 (viper-set-unread-command-events unmatched-suffix))
627 ;; If not a macro, or the macro is suppressed while defining another
628 ;; macro, put keyseq back on the event queue
629 (viper-set-unread-command-events event-seq)
630 ;; if the user typed arg, then use it if prefix arg is not set by
631 ;; some other command (setting prefix arg can happen if we do, say,
632 ;; 2dw and there is a macro starting with 2. Then control will go to
634 (or prefix-arg (setq prefix-arg count))
635 (setq command (key-binding (read-key-sequence nil)))
636 (if (commandp command)
637 (command-execute command)
643 ;;; Displaying and completing macros
645 (defun viper-describe-kbd-macros ()
646 "Show currently defined keyboard macros."
648 (with-output-to-temp-buffer " *viper-info*"
649 (princ "Macros in Vi state:\n===================\n")
650 (mapc 'viper-describe-one-macro viper-vi-kbd-macro-alist)
651 (princ "\n\nMacros in Insert and Replace states:\n====================================\n")
652 (mapc 'viper-describe-one-macro viper-insert-kbd-macro-alist)
653 (princ "\n\nMacros in Emacs state:\n======================\n")
654 (mapcar 'viper-describe-one-macro viper-emacs-kbd-macro-alist)
657 (defun viper-describe-one-macro (macro)
658 (princ (format "\n *** Mappings for %S:\n ------------\n"
659 (viper-display-macro (car macro))))
660 (princ " ** Buffer-specific:")
661 (if (viper-kbd-buf-alist macro)
662 (mapc 'viper-describe-one-macro-elt (viper-kbd-buf-alist macro))
664 (princ "\n ** Mode-specific:")
665 (if (viper-kbd-mode-alist macro)
666 (mapc 'viper-describe-one-macro-elt (viper-kbd-mode-alist macro))
668 (princ "\n ** Global:")
669 (if (viper-kbd-global-definition macro)
670 (princ (format "\n %S" (cdr (viper-kbd-global-pair macro))))
674 (defun viper-describe-one-macro-elt (elt)
675 (let ((name (car elt))
677 (princ (format "\n * %S:\n %S\n" name defn))))
681 ;; check if SEQ is a prefix of some car of an element in ALIST
682 (defun viper-keyseq-is-a-possible-macro (seq alist)
683 (let ((converted-seq (viper-events-to-macro seq)))
686 (lambda (elt) (viper-prefix-subseq-p converted-seq elt))
687 (viper-this-buffer-macros alist))))))
689 ;; whether SEQ1 is a prefix of SEQ2
690 (defun viper-prefix-subseq-p (seq1 seq2)
691 (let ((len1 (length seq1))
692 (len2 (length seq2)))
694 (equal seq1 (viper-subseq seq2 0 len1)))))
696 ;; find the longest common prefix
697 (defun viper-common-seq-prefix (&rest seqs)
698 (let* ((first (car seqs))
703 (if (= (length seqs) 0)
705 (setq len (apply 'min (mapcar 'length seqs))))
708 (mapcar (lambda (s) (equal (elt first idx) (elt s idx)))
710 (setq pref (vconcat pref (vector (elt first idx)))))
714 ;; get all sequences that match PREFIX from a given A-LIST
715 (defun viper-extract-matching-alist-members (pref alist)
716 (delq nil (mapcar (lambda (elt) (if (viper-prefix-subseq-p pref elt) elt))
717 (viper-this-buffer-macros alist))))
719 (defun viper-do-sequence-completion (seq alist compl-message)
720 (let* ((matches (viper-extract-matching-alist-members seq alist))
721 (new-seq (apply 'viper-common-seq-prefix matches))
723 (cond ((and (equal seq new-seq) (= (length matches) 1))
724 (message "%s (Sole completion)" compl-message)
727 (message "%s (No match)" compl-message)
730 ((member seq matches)
731 (message "%s (Complete, but not unique)" compl-message)
733 (viper-display-vector-completions matches))
735 (viper-display-vector-completions matches)))
739 (defun viper-display-vector-completions (list)
740 (with-output-to-temp-buffer "*Completions*"
741 (display-completion-list
742 (mapcar 'prin1-to-string
743 (mapcar 'viper-display-macro list)))))
747 ;; alist is the alist of macros
748 ;; str is the fast key sequence entered
749 ;; returns: (matching-macro-def . unmatched-suffix-start-index)
750 (defun viper-find-best-matching-macro (alist str)
753 (str-len (length str))
754 match unmatched-start-idx found macro-def)
755 (while (and (not found) lis)
756 (setq macro-def (car lis)
757 def-len (length (car macro-def)))
758 (if (and (>= str-len def-len)
759 (equal (car macro-def) (viper-subseq str 0 def-len)))
760 (if (or (viper-kbd-buf-definition macro-def)
761 (viper-kbd-mode-definition macro-def)
762 (viper-kbd-global-definition macro-def))
765 (setq lis (cdr lis)))
768 (setq match macro-def
769 unmatched-start-idx def-len)
771 unmatched-start-idx 0))
773 (cons match unmatched-start-idx)))
777 ;; returns a list of names of macros defined for the current buffer
778 (defun viper-this-buffer-macros (macro-alist)
781 (mapcar (lambda (elt)
782 (if (or (viper-kbd-buf-definition elt)
783 (viper-kbd-mode-definition elt)
784 (viper-kbd-global-definition elt))
787 (setq candidates (delq nil candidates))))
790 ;; if seq of Viper key symbols (representing a macro) can be converted to a
791 ;; string--do so. Otherwise, do nothing.
792 (defun viper-display-macro (macro-name-or-body)
793 (cond ((viper-char-symbol-sequence-p macro-name-or-body)
794 (mapconcat 'symbol-name macro-name-or-body ""))
795 ((viper-char-array-p macro-name-or-body)
796 (mapconcat 'char-to-string macro-name-or-body ""))
797 (t macro-name-or-body)))
799 ;; convert sequence of events (that came presumably from emacs kbd macro) into
800 ;; Viper's macro, which is a vector of the form
802 ;; Each desc is either a symbol of (meta symb), (shift symb), etc.
803 ;; Here we purge events that happen to be lists. In most cases, these events
804 ;; got into a macro definition unintentionally; say, when the user moves mouse
805 ;; during a macro definition, then something like (switch-frame ...) might get
806 ;; in. Another reason for purging lists-events is that we can't store them in
807 ;; textual form (say, in .emacs) and then read them back.
808 (defun viper-events-to-macro (event-seq)
809 (vconcat (delq nil (mapcar (lambda (elt) (if (consp elt)
811 (viper-event-key elt)))
814 ;; convert strings or arrays of characters to Viper macro form
815 (defun viper-char-array-to-macro (array)
816 (let ((vec (vconcat array))
818 (if (featurep 'xemacs)
819 (setq macro (mapcar 'character-to-event vec))
821 (vconcat (mapcar 'viper-event-key macro))))
823 ;; For macros bodies and names, goes over MACRO and checks if all members are
824 ;; names of keys (actually, it only checks if they are symbols or lists
825 ;; if a digit is found, it is converted into a symbol (e.g., 0 -> \0, etc).
826 ;; If MACRO is not a list or vector -- doesn't change MACRO.
827 (defun viper-fixup-macro (macro)
828 (let ((len (length macro))
831 (if (or (vectorp macro) (listp macro))
832 (while (and (< idx len) (not break))
833 (setq elt (elt macro idx))
836 (if (and (<= 0 elt) (<= elt 9))
837 (cond ((arrayp macro)
840 (intern (char-to-string (+ ?0 elt)))))
842 (setcar (nthcdr idx macro)
843 (intern (char-to-string (+ ?0 elt)))))
846 (viper-fixup-macro elt))
849 (setq idx (1+ idx))))
852 (error "Wrong type macro component, symbol-or-listp, %S" elt)
855 (defun viper-macro-to-events (macro-body)
856 (vconcat (mapcar 'viper-key-to-emacs-key macro-body)))
860 ;;; Reading fast key sequences
862 ;; Assuming that CHAR was the first character in a fast succession of key
863 ;; strokes, read the rest. Return the vector of keys that was entered in
864 ;; this fast succession of key strokes.
865 ;; A fast keysequence is one that is terminated by a pause longer than
866 ;; viper-fast-keyseq-timeout.
867 (defun viper-read-fast-keysequence (event macro-alist)
868 (let ((lis (vector event))
870 (while (and (viper-fast-keysequence-p)
871 (viper-keyseq-is-a-possible-macro lis macro-alist))
872 ;; Seems that viper-read-event is more robust here. We need to be able to
873 ;; place these events on unread-command-events list. If we use
874 ;; viper-read-key then events will be converted to keys, and sometimes
875 ;; (e.g., (control \[)) those keys differ from the corresponding events.
876 ;; So, do not use (setq next-event (viper-read-key))
877 (setq next-event (viper-read-event))
878 (or (viper-mouse-event-p next-event)
879 (setq lis (vconcat lis (vector next-event)))))
883 ;;; Keyboard macros in registers
885 ;; sets register to last-kbd-macro carefully.
886 (defun viper-set-register-macro (reg)
887 (if (get-register reg)
888 (if (y-or-n-p "Register contains data. Overwrite? ")
891 "Macro not saved in register. Can still be invoked via `C-x e'")))
892 (set-register reg last-kbd-macro))
894 (defun viper-register-macro (count)
895 "Keyboard macros in registers - a modified \@ command."
897 (let ((reg (downcase (read-char))))
898 (cond ((or (and (<= ?a reg) (<= reg ?z)))
899 (setq viper-last-macro-reg reg)
900 (if defining-kbd-macro
903 (viper-set-register-macro reg))
904 (execute-kbd-macro (get-register reg) count)))
905 ((or (= ?@ reg) (= ?\^j reg) (= ?\^m reg))
906 (if viper-last-macro-reg
908 (error "No previous kbd macro"))
909 (execute-kbd-macro (get-register viper-last-macro-reg) count))
911 (start-kbd-macro count))
913 (setq reg (downcase (read-char)))
914 (if (or (and (<= ?a reg) (<= reg ?z)))
916 (setq viper-last-macro-reg reg)
917 (viper-set-register-macro reg))))
919 (error "`%c': Unknown register" reg)))))
922 (defun viper-global-execute ()
923 "Call last keyboard macro for each line in the region."
924 (if (> (point) (mark t)) (exchange-point-and-mark))
926 (call-last-kbd-macro)
927 (while (< (point) (mark t))
930 (call-last-kbd-macro)))
933 ;;; viper-macs.el ends here