filename.keyboards

contains two types of items:

1) Alternative keyboard definitions, including British, French, German, Italian, Spanish and USA for PC type systems (AP/SCO, AP/Native, AP/DOS), for the TCL verb 'set-kbrd'.

2) Keyboard input translation items for the TCL verb 'set-imap'.

The format of the keyboard input translation for 'set-imap' is as follows:

- Attribute one must contain the keyword 'IMAP', optionally followed by one or more modifiers, separated by spaces. Valid modifiers are:

'esc-data'

Sets esc-data. This option should be used if any input sequence contains an escape.

'esc-level'

Sets esc-level. This option could be used if no input sequence contains an escape.

'xcs-on'

Enables the extended character set (8 bit characters).

'xcs-off'

Disables the extended character set.

'timeout' value

Sets the default timeout to 'value', expressed in milliseconds. This value can be overridden on a per-port basis by 'set-imap'. See 'set-imap' for the meaning of the timeout and precaution about this feature.

- Each line defines a translation where the input sequence and the converted sequence are separated by a colon (':'). If the converted string is null, then the input sequence corresponds to a key which will be ignored.

'input sequence' : 'converted sequence'

- Any text after a '*' is ignored, except when enclosed in quotes. Spaces are ignored, except when enclosed in quotes. Empty lines are ignored.

- Each element in the input sequence or the converted string are separated by commas.

- Characters and strings are represented by c'abc..' or c'abc...'. Example:
c']'
c']A'

- Hexadecimal values and strings are represented by x'NN' or x'NNNNNN..', where each pair of hexadecimal digits are assembled into one byte. Example:
x'ff'
x'27ff'

- Decimal values are represented normally.

- Control characters are specified by a caret ('^') followed by the corresponding letter, in upper or lower case. Example:
^a

- The following keywords can be used anywhere to represent the usual ASCII codes:

BS : x'08' LF : x'0A' CR : x'0D'
ESC : x'1F' DEL: x'7F'