KEYCAP(5)                 OpenBSD Programmer's Manual                KEYCAP(5)

NAME
     keycap - keyboard mapping data base

SYNOPSIS
     keycap

DESCRIPTION
     The keycap file is a data base describing keyboard mappings, used by
     kcon(1).

     Entries in keycap consist of a number of `:'-separated fields.  The first
     entry for each mapping gives the names that are known for the mapping,
     separated by `|' characters.  All names but the first and last should be
     in lower case and contain no blanks; the last name may well contain upper
     case and blanks for readability.

CAPABILITIES
     Name      Type      Description
     de        bool      Resets Keyboard mapping to compiled-in default
     D<n>      bool      Disables key <n> completely

     m<n>      num       specify key numbers for ALT keys
     l<n>      num       specify key numbers for ALTGR keys
     h<n>      num       specify key numbers for SHIFT keys
     t<n>      num       specify key numbers for CONTROL keys
     ca<n>     num       specify key number for the CAPS LOCK key
     sh<n>     num       specify key number for the SHIFT LOCK key
     nl<n>     num       specify key number for the NUM LOCK key
     sc<n>     num       specify key number for the SCROLL LOCK key

     K<n>      str       bind a string to a unshifted (normal) key
     S<n>      str       bind a string to a shifted key
     C<n>      str       bind a string to a control key
     A<n>      str       bind a string to a altgr key

     tc        str       Entry of similar map - must be last.

     Parameter <n> describing the key number can have values from 1 to 128.

     A string parameter may have up to 15 characters.


   A Sample Entry
     The following entry, which describes a test entry, is among the very easy
     entries in the keycap file as of this writing.

     tt|test|Test entry which swaps y and z:\
             :K22=z:S22=Z:C22=\032:\
             :K46=y:S46=Y:C46=\031:


     Entries may continue onto multiple lines by giving a \ as the last char-
     acter of a line. Comments may be included on lines beginning with `#'.

FILES
     /usr/share/misc/keycap.pcvt  contains keyboard mapping descriptions

SEE ALSO
     kcon(1), keycap(3)

EXAMPLES
     The entry ``l1#60'' sets the keynumber for the ALTGR key to 60.

     The entry ``K100=hugo'' binds the string 'hugo' to the key number 100.

     The entry ``K100=^D'' binds the control character EOT (0x04) to the key
     number 100.

     The entry ``K100=\000'' binds the control character NUL (0x00) to the key
     number 100.





OpenBSD 2.8                     January 3, 1993                              2
