annotate lisp/term/tvi970.el @ 78737:5ec8fe8efb1e

Improve wording of previous change.

;;; tvi970.el --- terminal support for the Televideo 970

;; Copyright (C) 1992, 2001, 2002, 2003, 2004, 2005,
;;   2006, 2007 Free Software Foundation, Inc.

;; Author: Jim Blandy <[e-mail]>, January 1992
;; Keywords: terminals

;; This file is part of GNU Emacs.

;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 3, or (at your option)
;; any later version.

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING.  If not, write to the
;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
;; Boston, MA 02110-1301, USA.

;;; Commentary:

;; Uses the Emacs 19 terminal initialization features --- won't work with 18.

;;; Code:

(defun terminal-init-tvi970 ()
  "Terminal initialization function for tvi970."
  (or (lookup-key function-key-map "\e[")
      (define-key function-key-map "\e[" (make-keymap)))
  ;; (or (lookup-key function-key-map "\eO")
  ;;    (define-key function-key-map "\eO" (make-keymap)))

  ;; Miscellaneous keys
  (mapcar (function (lambda (key-binding)
		      (define-key function-key-map
			(car key-binding) (nth 1 key-binding))))
	  '(
	    ;; These are set up by termcap or terminfo
	    ;; ("\eOP"	[kp-f1])
	    ;; ("\eOQ"	[kp-f2])
	    ;; ("\eOR"	[kp-f3])
	    ;; ("\eOS"	[kp-f4])

	    ;; These might br set by terminfo
	    ("\e[H"	[home])
	    ("\e[Z"	[backtab])
	    ("\e[i"	[print])
	    ("\e[@"	[insert])
	    ("\e[L"	[insertline])
	    ("\e[M"	[deleteline])
	    ("\e[U"	[next])	;; actually the `page' key

	    ;; These won't be set up by either
	    ("\eOm"	[kp-subtract])
	    ("\eOl"	[kp-separator])
	    ("\eOn"	[kp-decimal])
	    ("\eOM"	[kp-enter])

	    ;; These won't be set up by either either
	    ("\e[K"	[key_eol])	;; Not an X keysym
	    ("\e[J"	[key_eos])	;; Not an X keysym
	    ("\e[2J"	[key_clear])	;; Not an X keysym
	    ("\e[P"	[key_dc])	;; Not an X keysym
	    ("\e[g"	[S-tab])	;; Not an X keysym
	    ("\e[2N"	[clearentry])	;; Not an X keysym
	    ("\e[2K"	[S-clearentry])	;; Not an X keysym
	    ("\e[E"	[?\C-j])	;; Not an X keysym
	    ("\e[g"	[S-backtab])	;; Not an X keysym
	    ("\e[?1i"	[key_sprint])	;; Not an X keysym
	    ("\e[4h"	[key_sic])	;; Not an X keysym
	    ("\e[4l"	[S-delete])	;; Not an X keysym
	    ("\e[Q"	[S-insertline])	;; Not an X keysym
	    ("\e[1Q"	[key_sdl])	;; Not an X keysym
	    ("\e[19l"	[key_seol])	;; Not an X keysym
	    ("\e[19h"	[S-erasepage])	;; Not an X keysym
	    ("\e[V"	[S-page])	;; Not an X keysym
	    ("\eS"	[send])		;; Not an X keysym
	    ("\e5"	[S-send])	;; Not an X keysym
	    ))

  ;; The numeric keypad keys.
  (let ((i 0))
    (while (< i 10)
      (define-key function-key-map
	(format "\eO%c" (+ i ?p))
	(vector (intern (format "kp-%d" i))))
      (setq i (1+ i))))
  ;; The numbered function keys.
  (let ((i 0))
    (while (< i 16)
      (define-key function-key-map
	(format "\e?%c" (+ i ?a))
	(vector (intern (format "f%d" (1+ i)))))
      (define-key function-key-map
	(format "\e?%c" (+ i ?A))
	(vector (intern (format "S-f%d" (1+ i)))))
      (setq i (1+ i))))

  (tvi970-set-keypad-mode 1))

;;; Should keypad numbers send ordinary digits or distinct escape sequences?
(defvar tvi970-keypad-numeric nil
  "Non-nil means the terminal should be in numeric keypad mode.
Do not set this variable!  Call the function `tvi970-set-keypad-mode'.")

(defun tvi970-set-keypad-mode (&optional arg)
  "Set the current mode of the TVI 970 numeric keypad.
In ``numeric keypad mode'', the number keys on the keypad act as
ordinary digits.  In ``alternate keypad mode'', the keys send distinct
escape sequences, meaning that they can have their own bindings,
independent of the normal number keys.
With no argument, toggle between the two possible modes.
With a positive argument, select alternate keypad mode.
With a negative argument, select numeric keypad mode."
  (interactive "P")
  (setq tvi970-keypad-numeric
	(if (null arg)
	    (not tvi970-keypad-numeric)
	  (> (prefix-numeric-value arg) 0)))
  (send-string-to-terminal (if tvi970-keypad-numeric "\e=" "\e>")))

;;; arch-tag: c1334cf0-1462-41c3-a963-c077d175f8f0
;;; tvi970.el ends here