REMOVE_KEY_MAP

REMOVE_KEY_MAP deletes a key-map(s) from a key-map-list. The name of the key-map-list from which a given key-map is going to be removed is passed as the first parameter. The name of the key-map to remove is passed as the second parameter. If the optional keyword ALL is passed as the third argument, every occurrence of the key-map is deleted from the key-map-list. By default, only the first key-map in the key-map-list is deleted.

Syntax:

REMOVE_KEY_MAP (string, string [, ALL])

Example:

The following removes the default key-map TPU$KEY_MAP from the default key-map-list TPU$KEY_MAP_LIST.

REMOVE_KEY_MAP ("TPU$KEY_MAP_LIST", "TPU$KEY_MAP");

Errors:

TPU$_BADKEY Only ALL is valid as third parameter.

TPU$_EMPTYKMLIST No key-maps in list.

TPU$_KEYMAPNOTFND Unable to locate key-map.

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

TPU$_NOKEYMAPLIST Undefined key-map-list.

Related Builtins: