-;;; vcursor.el --- manipulate an alternative ("virtual") cursor.
+;;; vcursor.el --- manipulate an alternative ("virtual") cursor
;; Copyright (C) 1994, 1996, 1998 Free Software Foundation, Inc.
;; Author: Peter Stephenson <pws@ibmth.df.unipi.it>
+;; Maintainer: FSF
;; Keywords: virtual cursor, convenience
;; This file is part of GNU Emacs.
;; or t), which means that copying from the vcursor will be turned
;; off after any operation not involving the vcursor, but the
;; vcursor itself will be left alone.
-;; - should now work unmodified under XEmacs
;; - works on dumb terminals with Emacs 19.29 and later
;; - new keymap vcursor-map for binding to a prefix key
;; - vcursor-compare-windows substantially improved
;; other alternatives (search for "Oemacs"). There is also a keymap
;; which you can bind to a prefix key, which may give some more
;; intuitive alternatives in some cases, see `The vcursor keymap' below.
-;;
+;;
;; Holding down control and shift and pressing insert (vcursor-copy)
;; copies one character from wherever the virtual cursor is to point;
;; point and the virtual cursor advance in the separate and equal
;; station to which... (etc.). M-C-S-return (vcursor-copy-line)
;; copies to the end of the line instead of just one character,
;; C-S-delete or C-S-remove (vcursor-copy-word) copies a word.
-;;
+;;
;; A more general way of copying is to use C-S-tab, which is a toggle.
;; In the "on" state, moving the virtual cursor will copy the
;; moved-over text to the normal cursor position (including when going
;; window. (See the function (vcursor-find-window) for details of how
;; this window is chosen.) This gives you fingertip control over two
;; windows at once.
-;;
+;;
;; C-S-return (vcursor-disable) disables the virtual cursor, removing
;; it so that it starts from point whenever you move it again --- note
;; that simply moving the cursor and virtual cursor on top of one
;; another does not have this effect.
-;;
+;;
;; If you give C-S-return a positive prefix arg, it will also delete the
;; window (unless it's the current one). Whenever the virtual cursor
;; goes off-screen in its own window, point in that window is moved as
;; remember the current cursor location for examining or copying from
;; that buffer. (I just hit C-S-right C-S-left, but I'm a hopeless
;; lowbrow.)
-;;
+;;
;; There is also C-S-f6 (vcursor-other-window) which behaves like
;; C-x o on the virtual rather than the real cursor, except that it
;; will create another window if necessary.
;;
;; Key bindings
;; ============
-;;
+;;
;; There is an alternative set of key bindings which will be used
;; automatically for a PC if Oemacs is detected. This set uses separate
;; control, shift and meta keys with function keys 1 to 10. In
;;
;; If Emacs has set the variable window-system to nil, vcursor will
;; assume that overlays cannot be displayed in a different face,
-;; and will instead use an string (the variable vcursor-string, by
+;; and will instead use a string (the variable vcursor-string, by
;; default "**>") to show its position. This was first implemented
;; in Emacs 19.29. Unlike the old-fashioned overlay arrow (as used
;; by debuggers), this appears between existing text, which can
;; get an easy key binding for the vcursor keys on a generic terminal.
;; Consequently a special keymap is defined for you to use traditional
;; methods: the keymap, however, is available on any terminal type.
-;;
+;;
;; The vcursor keymap
;; ==================
;;
;; does something else. To get this effect, set
;; vcursor-interpret-input to t. This is normally not a good idea as
;; interpreting input is very much slower than copying text.
-;;
+;;
;; Un-features
;; ===========
;;
;; - The logic in vcursor-find-window is rather complicated and
;; therefore bug-prone, though in practice it seems to work OK.
;;
-;; Possible enhnacements:
+;; Possible enhancements:
;; It would be easy to implement vcursor-push (save vcursor position
;; as mark and deactivate) and vcursor-pop (deactivate vcursor and
;; move to last pushed position) functions.
;;; Code:
+(eval-when-compile (require 'compare-w))
+
(defgroup vcursor nil
"Manipulate an alternative (\"virtual\") cursor."
:prefix "vcursor-"
:type '(choice (const t) (const nil) (const copy))
:group 'vcursor)
+(defcustom vcursor-modifiers (list 'control 'shift)
+ "*A list of modifiers that are used to define vcursor key bindings."
+ :type '(repeat symbol)
+ :group 'vcursor)
+
;; Needed for defcustom, must be up here
-(if (not (string-match "XEmacs" emacs-version))
- (defun vcursor-cs-binding (base &optional meta)
- (read (concat "[" (if meta "M-" "") "C-S-" base "]")))
- (require 'overlay)
- (defun vcursor-cs-binding (base &optional meta)
- (read (concat "[(" (if meta "meta " "") "control shift "
- base ")]")))
- )
+(defun vcursor-cs-binding (base &optional meta)
+ (vector (let ((key (append vcursor-modifiers (list (intern base)))))
+ (if meta
+ (cons 'meta key)
+ key))))
(defun vcursor-bind-keys (var value)
"Alter the value of the variable VAR to VALUE, binding keys as required.
;;; "\M-[\C-f\M-\C-s" C-S-delete
;;; "\M-[\C-f\M-\C-d" C-S-prior
;;; "\M-[\C-fv" C-S-next
-;;;
+;;;
;;; "\M-[\C-f^" C-S-f1
;;; "\M-[\C-f_" C-S-f2
;;; "\M-[\C-f`" C-S-f3
(global-set-key (vcursor-cs-binding "down") 'vcursor-next-line)
(global-set-key (vcursor-cs-binding "left") 'vcursor-backward-char)
(global-set-key (vcursor-cs-binding "right") 'vcursor-forward-char)
-
+
(global-set-key (vcursor-cs-binding "return") 'vcursor-disable)
(global-set-key (vcursor-cs-binding "insert") 'vcursor-copy)
(global-set-key (vcursor-cs-binding "delete") 'vcursor-copy-word)
(global-set-key (vcursor-cs-binding "down" t) 'vcursor-end-of-buffer)
(global-set-key (vcursor-cs-binding "prior") 'vcursor-scroll-down)
(global-set-key (vcursor-cs-binding "next") 'vcursor-scroll-up)
-
+
(global-set-key (vcursor-cs-binding "f6") 'vcursor-other-window)
(global-set-key (vcursor-cs-binding "f7") 'vcursor-goto)
- (global-set-key (vcursor-cs-binding "select")
+ (global-set-key (vcursor-cs-binding "select")
'vcursor-swap-point) ; DEC keyboards
(global-set-key (vcursor-cs-binding "tab" t) 'vcursor-swap-point)
- (global-set-key (vcursor-cs-binding "find")
+ (global-set-key (vcursor-cs-binding "find")
'vcursor-isearch-forward) ; DEC keyboards
(global-set-key (vcursor-cs-binding "f8") 'vcursor-isearch-forward)
:group 'vcursor
:version "20.3")
-(defvar vcursor-overlay nil
+(defvar vcursor-overlay nil
"Overlay for the virtual cursor.
It is nil if that is not enabled.")
;; could do some memq-ing with last-command instead, but this will
;; automatically handle any new commands using the primitives.
-(defcustom vcursor-copy-flag nil
+(defcustom vcursor-copy-flag nil
"*Non-nil means moving vcursor should copy characters moved over to point."
:type 'boolean
:group 'vcursor)
;; If vcursor-key-bindings is already set on loading, bind the keys now.
;; This hybrid way of doing it retains compatibility while allowing
;; customize to work smoothly.
-(if vcursor-key-bindings
+(if vcursor-key-bindings
(vcursor-bind-keys 'vcursor-key-bindings vcursor-key-bindings))
(defun vcursor-locate ()
(and (overlayp vcursor-overlay)
(overlay-buffer vcursor-overlay)
(set-buffer (overlay-buffer vcursor-overlay))
- (overlay-start vcursor-overlay) ; needed for XEmacs
(goto-char (overlay-start vcursor-overlay)))
)
(pos-visible-in-window-p (point) vcursor-window))
(progn
(walk-windows
- (function
+ (function
(lambda (win)
(and (not winok)
(eq (current-buffer) (window-buffer win))
(move-overlay vcursor-overlay pt (+ pt 1) (current-buffer))
(setq vcursor-overlay (make-overlay pt (+ pt 1)))
(or window-system
+ (display-color-p)
(overlay-put vcursor-overlay 'before-string vcursor-string))
(overlay-put vcursor-overlay 'face 'vcursor))
(or leave-w (vcursor-find-window nil t))
((and (overlayp vcursor-overlay) (overlay-start vcursor-overlay))
t)
(arg nil)
- (t (error "The virtual cursor is not active now.")))
+ (t (error "The virtual cursor is not active now")))
)
(defun vcursor-disable (&optional arg)
With a positive prefix ARG, the first window in cyclic order
displaying the virtual cursor (or which was recently displaying the
-virutal cursor) will be deleted unless it's the selected
+virtual cursor) will be deleted unless it's the selected
window.
With a negative prefix argument, enable the virtual cursor: make it
(defun vcursor-other-window (n &optional all-frames)
"Activate the virtual cursor in another window.
-This is the next window cylically after one currently showing the
+This is the next window cyclically after one currently showing the
virtual cursor, or else after the current selected window. If there
is no other window, the current window is split.
(defun vcursor-toggle-vcursor-map (&optional force noredisp)
"Toggle the state of the vcursor key map.
When on, the keys defined in it are mapped directly on top of the main
-keymap, allowing you to move the vcursor with ordinary motion keys.
+keymap, allowing you to move the vcursor with ordinary motion keys.
An indication \"!VC\" appears in the mode list. The effect is
local to the current buffer.
With prefix FORCE, turn on, or off if it is 0.
(provide 'vcursor)
-;; vcursor.el ends here
+;;; arch-tag: cdfe1cdc-2c46-4046-88e4-ed57d20f7aca
+;;; vcursor.el ends here
HCoop / bpt / emacs.git / blobdiff