lisp/emulation/edt-pc.el

   1 ;;; edt-pc.el --- enhanced EDT keypad mode emulation for PC 101 keyboards
   2
   3 ;; Copyright (C) 1986, 1994-1995, 2001-2017 Free Software Foundation,
   4 ;; Inc.
   5
   6 ;; Author: Kevin Gallagher <kevin.gal@verizon.net>
   7 ;; Maintainer: Kevin Gallagher <kevin.gal@verizon.net>
   8 ;; Keywords: emulations
   9 ;; Package: edt
  10
  11 ;; This file is part of GNU Emacs.
  12
  13 ;; GNU Emacs is free software: you can redistribute it and/or modify
  14 ;; it under the terms of the GNU General Public License as published by
  15 ;; the Free Software Foundation, either version 3 of the License, or
  16 ;; (at your option) any later version.
  17
  18 ;; GNU Emacs is distributed in the hope that it will be useful,
  19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 ;; GNU General Public License for more details.
  22
  23 ;; You should have received a copy of the GNU General Public License
  24 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  25
  26 ;;; Commentary:
  27
  28 ;; See Info node `edt' for more details.
  29
  30 ;; ====================================================================
  31 \f
  32 ;;;;
  33 ;;;; KEY TRANSLATIONS
  34 ;;;;
  35
  36 ;; Associate EDT keynames with Emacs terminal function vector names.
  37 ;;
  38 ;; To emulate the DEC LK-201 keypad keys on the PC 101 keyboard,
  39 ;; NumLock must be ON.
  40 ;;
  41 ;; The PC keypad keys are mapped to the corresponding DEC LK-201
  42 ;; keypad keys according to the corresponding physical position on
  43 ;; the keyboard.  Thus, the physical position of the PC keypad key
  44 ;; determines its function, not the PC keycap name.
  45 ;;
  46 ;; There are two LK-201 keypad keys needing special handling: PF1 and
  47 ;; the keypad comma key.
  48 ;;
  49 ;; PF1:
  50 ;;  Most PC software does not see a press of the NumLock key.  A TSR
  51 ;;  program distributed with MS-Kermit to support its VT-100 emulation
  52 ;;  solves this problem.  The TSR, called GOLD, causes a press of the
  53 ;;  keypad NumLock key to look as if the PC F1 key were pressed.  So
  54 ;;  the PC F1 key is mapped here to behave as the PF1 (GOLD) key.
  55 ;;  Then with GOLD loaded, the NumLock key will behave as the GOLD key.
  56 ;;
  57 ;;  By the way, with GOLD loaded, you can still toggle numlock on/off.
  58 ;;  GOLD binds this to Shift-NumLock.
  59 ;;
  60 ;; Keypad Comma:
  61 ;;  There is no physical PC keypad key to correspond to the LK-201
  62 ;;  keypad comma key.  So, the EDT Emulation is configured below to
  63 ;;  ignore attempts to bind functions to the keypad comma key.
  64 ;;
  65 ;; Finally, F2 through F12 are also available for making key bindings
  66 ;; in the EDT Emulation on the PC.  F1 is reserved for the GOLD key,
  67 ;; so don't attempt to bind anything to it.  Also, F13, F14, HELP, DO,
  68 ;; and F17 through F20 do not exist on the PC, so the EDT emulation is
  69 ;; configured below to ignore attempts to bind functions to those keys.
  70 ;;
  71
  72 ;;; Code:
  73
  74 (defconst *EDT-keys*
  75   '(("KP0" . [kp-0]) ("KP1" . [kp-1]) ("KP2" . [kp-2]) ("KP3" . [kp-3])
  76     ("KP4" . [kp-4]) ("KP5" . [kp-5]) ("KP6" . [kp-6]) ("KP7" . [kp-7])
  77     ("KP8" . [kp-8]) ("KP9" . [kp-9]) ("KP," . "" )
  78     ("KP-" . [kp-add]) ("KPP" . [kp-decimal]) ("KPE" . [kp-enter])
  79     ("PF1" . [f1]) ("PF2" . [kp-divide]) ("PF3" . [kp-multiply])
  80     ("PF4" . [kp-subtract])
  81     ("UP" . [up]) ("DOWN" . [down]) ("RIGHT" . [right]) ("LEFT" . [left])
  82     ("FIND" . [insert]) ("INSERT" . [home]) ("REMOVE" . [prior])
  83     ("SELECT" . [delete]) ("PREVIOUS" . [end]) ("NEXT" . [next])
  84     ("F1" . "" ) ("F2" . [f2]) ("F3" . [f3]) ("F4" . [f4]) ("F5" . [f5])
  85     ("F6" . [f6]) ("F7" . [f7]) ("F8" . [f8]) ("F9" . [f9]) ("F10" . [f10])
  86     ("F11" . [f11]) ("F12" . [f12]) ("F13" . "" ) ("F14" . "" )
  87     ("HELP" . "" ) ("DO" . "" ) ("F17" . "" ) ("F18" . "" )
  88     ("F19" . "" ) ("F20" . "" )))
  89
  90 ;;; edt-pc.el ends here