CREATE_KEY_MAP_LIST

CREATE_KEY_MAP_LIST creates, names, and builds a complete key-map-list. CREATE_KEY_MAP_LIST returns the name of the key-map-list created. The key-map-list-name is passed as the first parameter. The structure is based on previously defined key-map(s) passed as the second parameter.

When nu/TPU is started, one key-map named TPU$KEY_MAP and one key-map-list named TPU$KEY_MAP_LIST are predefined. Key-map-lists contain four settings: one for self-inserting characters and the other three telling what to do before keys are typed, after keys are typed, and when keys are undefined. These settings are altered by the SET built-in.

Note that CREATE_KEY_MAP_LIST makes the list name uppercase automatically, and self-inserting is turned on.

Syntax:

string := CREATE_KEY_MAP_LIST (string, string [,...] )

Example:

The following example shows what happens when nu/TPU starts up. The default key-map, TPU$KEY_MAP, is created and stored in the variable map$1. Then nu/TPU creates the default key-map-list TPU$KEY_MAP_ LIST with the information in map$1.

map$1:= CREATE_KEY_MAP ("TPU$KEY_MAP");

CREATE_KEY_MAP_LIST ("TPU$KEY_MAP_LIST", map$1);

Errors:

TPU$_DUPKEYMAP Not a unique key-map-name.

TPU$_DUPKEYMAPLIST Not a unique key-map-list.

TPU$_NOKEYMAP The string is not a key-map.

Related Builtins: