File: edt-mapper.el.html

[Part of the GNU Emacs EDT Emulation.]

 This Emacs Lisp program can be used to create an Emacs Lisp file
 that defines the mapping of the user's keyboard to the LK-201
 keyboard function keys and keypad keys (around which EDT has been
 designed). Please read the "Usage" AND "Known Problems" sections
 below before attempting to run this program. (The design of this
 file, edt-mapper.el, was heavily influenced by tpu-mapper.el.)

 Version 4.0 contains the following enhancements:

 1. If you access a workstation using an X Server, note that the
     initialization file generated by edt-mapper.el will now
     contain the name of the X Server vendor. This is a
     convenience for those who have access to their Unix account
     from more than one type of X Server. Since different X
     Servers typically require different EDT emulation
     initialization files, edt-mapper.el will now generate these
     different initialization files and save them with different
     names.

 2. Also, edt-mapper.el is now capable of binding an ASCII key
     sequence, providing the ASCII key sequence prefix is already
     known by Emacs to be a prefix. As a result, some
     terminal/keyboard/window system configurations, which don't
     have a complete set of sensible function key map bindings, can
     still be configured for EDT Emulation.


 Usage:

 Simply load this file into Emacs and run the function edt-mapper,
 using the following command.

   emacs -q -l edt-mapper -f edt-mapper

 The "-q" option prevents loading of your init file (commands
 therein might confuse this program).

 An instruction screen showing the typical LK-201 terminal
 functions keys will be displayed, and you will be prompted to
 press the keys on your keyboard which you want to emulate the
 corresponding LK-201 keys.

 Finally, you will be prompted for the name of the file to store
 the key definitions. If you chose the default, it will be found
 and loaded automatically when the EDT emulation is started. If
 you specify a different file name, you will need to set the
 variable "edt-keys-file" before starting the EDT emulation.
 Here's how you might go about doing that in your init file:

   (setq edt-keys-file (expand-file-name "~/.my-emacs-keys"))


 Known Problems:

 Sometimes, edt-mapper will ignore a key you press, and just
 continue to prompt for the same key. This can happen when your
 window manager sucks up the key and doesn't pass it on to Emacs,
 or it could be an Emacs bug. Either way, there's nothing that
 edt-mapper can do about it. You must press RETURN, to skip the
 current key and continue. Later, you and/or your local Emacs guru
 can try to figure out why the key is being ignored.

Defined variables (3)

edt-termSpecifies the terminal type, if applicable.
edt-window-systemName of window system through which the selected frame is displayed.
edt-xserverIndicates X server vendor name, if applicable.

Defined functions (1)

edt-map-key(IDENT DESCRIP)

Defined faces (0)