home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume15 / kbmap / part01 / kbmap.doc < prev    next >
Encoding:
Text File  |  1990-10-14  |  6.2 KB  |  203 lines
  1.  
  2.  
  3.      KBMAP(1)               Unix System V              KBMAP(1)
  4.  
  5.  
  6.      NAME
  7.       kbmap    - change keyboard scancode mapping
  8.  
  9.      SYNOPSIS
  10.       kbmap    [-i] [-1] [-g] [-n n] [d] [-e] [-m] [-a] [-t /dev/xxx] [file]
  11.          -i     = show    index of available maps
  12.          -q     = query which table is    currently in use
  13.          -g     = generate a key map table
  14.          -n n     = set keyboard    to map 'n' mapping
  15.          -d     = set keyboard    to normal mapping
  16.          -e     = set keyboard    to <esc>N emacs    mapping
  17.          -m     = set keyboard    to meta    (8bit) emacs mapping
  18.          -a     = do not convert <alt><ctl> and <alt><shf><ctl>
  19.          -t /dev/xxx = apply map to this device
  20.          file     = use specified key map file
  21.  
  22.  
  23.      DESCRIPTION
  24.       Kbmap    reads a    text file containg keyboard mapping
  25.       information and set the keyboard to the selected mapping.
  26.  
  27.       Kbmap    can create a standard mapping file
  28.       (/local/lib/kbmap.table) that    contains the system default
  29.       mapping as well as an    two different emacs mapping that allow
  30.       alt to be used as the    emacs meta-key.    Other keyboard
  31.       mappings may be manually added to the    kbmap.table file.
  32.  
  33.       Only root may    use this programme from    the console.
  34.  
  35.       It cannot be run from    an rc2.d/xxx file or cron.
  36.  
  37.       True META mapping (with 8th bit set) set with    -m cannot be
  38.       used with X11R2 (X11 does not    use the    standard keyboard
  39.       maps).  If you use X11R2 and the ascii console environments,
  40.       the -e option    should be used for emacs mapping simply    to
  41.       ensure that the .emacs files can be used in either mode
  42.       without change.
  43.  
  44.  
  45.      OPTIONS
  46.       -i   Show index of maps recorded in map.table.  The map
  47.            numbers may be used with    the -n option to select    maps
  48.            by number.
  49.  
  50.  
  51.       -q   The query option    causes the current scancode table in
  52.            the kernal to be    compared to all    of the tables in
  53.            kbmap.table. If a match is found, the name of the
  54.            currently active    table is printed.
  55.  
  56.            If vtlmgr is used, then an attempt is made to identify
  57.            which keyboard map is in    use in spite of    modifications
  58.  
  59.  
  60.      Page 1                          (printed 9/9/90)
  61.  
  62.  
  63.      KBMAP(1)               Unix System V              KBMAP(1)
  64.  
  65.  
  66.            made by vtlmgr.
  67.  
  68.  
  69.       -g   Generate    a new keyboard map file.  The systems current
  70.            keyboard    map is retrieved and written to    the
  71.            kbmap.table file.  Two mapping files for    emacs are
  72.            appended.  The system's keyboard    map is not updated.
  73.  
  74.  
  75.       file Select file to be the generated keyboard    map file,
  76.            usually kbmap.table.
  77.  
  78.  
  79.       -d   Select the system default map from kbmap.table and
  80.            update the system's current keyboard map.
  81.  
  82.  
  83.       -e   Select the emacs    default    map from kbmap.table and
  84.            update the system's current keyboard map.  Emacs    users
  85.            may use alt as the meta-key.   If you press the alt key
  86.            and a letter together, the letter is generated with the
  87.            escape sequence <esc>N<letter>.
  88.  
  89.            If this mapping is used,    the .emacs files should
  90.            contain the following:
  91.  
  92.             (define-key    global-map "\M-N" 'ESC-prefix)
  93.  
  94.            to enable the recognition of the    new escape sequences.
  95.  
  96.            The only    significant change to the AT&T standard
  97.            keyboard    mapping    is that    the <alt><del> meta is enabled
  98.            to allow    backward-kill-word.
  99.  
  100.  
  101.       -m   Select the emacs    meta-key 8th bit map from kbmap.table
  102.            and update the system's current keyboard    map.  Emacs
  103.            users may use alt as the    meta-key.   If you press the
  104.            alt key and a letter together, the letter is generated
  105.            as <letter> | 0x080.
  106.  
  107.            If this mapping is used,    the .emacs files should
  108.            contain the following:
  109.  
  110.             (setq meta-flag t)
  111.  
  112.            to enable the recognition 8th bit set meta characters.
  113.  
  114.            X11R2 will not recognize    8th bit    set characters.     As a
  115.            result, the -m option should not    be used    if you intend
  116.            to run emacs with X11R2.
  117.  
  118.  
  119.      Page 2                          (printed 9/9/90)
  120.  
  121.  
  122.      KBMAP(1)               Unix System V              KBMAP(1)
  123.  
  124.  
  125.       -n i Select the i'th map from    the kbmap.table    file and
  126.            update the system.  The system default map is 0 and the
  127.            emacs map is 1 or 2. If other keyboard maps are added
  128.            to the end of the kbmap.table file, then    they may be
  129.            accessed    by number.
  130.  
  131.  
  132.       -a   Normally, kbmap extends mapping for <alt><ctl> and
  133.            <alt><shif><ctl>    keys.  If the -a option    is used, these
  134.            will be disabled.
  135.  
  136.            If the -a is used, then the gnuemacs C-M- sequences
  137.            (such as    C-M-s (isearch-forward-regexp))    cannot use the
  138.            <alt><ctl><letter> combinations.     Instead, the <esc> +
  139.            <ctl><letter> sequence is used.
  140.  
  141.  
  142.       -t /dev/xxx
  143.            Use the specified device    rather than stdin.  (This is
  144.            not really useful.)
  145.  
  146.  
  147.      SETUP
  148.       Create a basic keyboard mapping file that contains both the
  149.       standard map and the emacs meta-key map:
  150.  
  151.             kbmap -g kbmap.table
  152.  
  153.       The current keyboard table is    fetched. The current mapping
  154.       information as described in the keymap_t structure is
  155.       written to disk file kbmap.table. The    meta-conversion    for
  156.       emacs    is performed on    the structure and the resulting
  157.       information is appended to kbmap.table. The new information
  158.       is NOT updated in the    kernal.
  159.  
  160.       Copy kbmap.table to /local/lib/kbmap.table (or other file as
  161.       specified during system compilation.)          Any keyboard
  162.       mapping may now be selected (using the default file
  163.       /local/lib/kbmap.table):
  164.  
  165.         kbmap -d    = select default map
  166.         kbmap -e    = select emacs <esc>N<letter> map
  167.         kbmap -m    = select emacs <letter>|0x080 meta map
  168.  
  169.       Alternatively, the key mapping may be    selected by number:
  170.  
  171.         kbmap -m 0  = select map 0 (default map)
  172.         kbmap -m 1  = select map 1 (emacs <letter>|0x08    meta-map)
  173.         kbmap -m 2  = select map 2 (normal <esc>N<letter> emacs)
  174.         kbmap -m 3  = select map 3 (your additional)
  175.            etc.
  176.  
  177.  
  178.      Page 3                          (printed 9/9/90)
  179.  
  180.  
  181.      KBMAP(1)               Unix System V              KBMAP(1)
  182.  
  183.  
  184.      NOTES
  185.       The changes made by kbmap are    reset to system    defaults
  186.       whenever the system is booted.  If permanent changes are
  187.       needed, then the system default mapping in
  188.       /etc/conf/pack.d/kd/Driver.o should be "zapped" with the
  189.       appropriate table and    the kernal rebuilt.
  190.  
  191.  
  192.      FILES
  193.       /local/lib/kbmap.table
  194.  
  195.  
  196.      AUTHOR
  197.       Tony Field (tony%ajfcal@cpsc.ucalgary.ca, tony@ajfcal)
  198.  
  199.  
  200.      Page 4                          (printed 9/9/90)
  201.  
  202.  
  203.