Manpages

KEYCAP(5) BSD File Formats 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 an 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 an 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 character of a line. Comments may be included on lines beginning with ’’#’’.

FILES
/usr/share/misc/keycap.pcvt

File containing 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.

BSD January 3, 1993 BSD