REMOVE_KEY_MAP

    Removes key maps from one or all key-map lists.

    Syntax

    REMOVE_KEY_MAP (string1, string2 [,ALL])

    Parameters

    string1    Specifies name of the key-map list containing the key map to
               be removed.

    string2    Specifies the name of the key map to be removed from the
               key-map list.

    ALL        Optionally, specifies that all the key maps with the name
               specified by string2 are to be removed from the key-map
               list.

 Examples

    The following example creates a key-map list name MY_KEYMAP_LIST.  The
    call to SHOW (KEY_MAP_LISTS) shows the key-map list contains three key
    maps:  KEYMAP_1, KEYMAP_2, and KEYMAP_1 again.  After the call to
    REMOVE_KEY_MAP, another call to SHOW (KEY_MAP_LISTS) shows the key-map
    list contains only KEYMAP_2.

    user$keymap_1 := CREATE_KEY_MAP ("keymap_1");
    user$keymap_2 := CREATE_KEY_MAP ("keymap_2");
    user$keymap_list := CREATE_KEY_MAP_LIST ("my_keymap_list",
                        user$keymap_1, user$keymap_2);
    ADD_KEY_MAP (user$keymap_list, "last", user$keymap_1);
         ~.
         ~.
    SHOW (KEY_MAP_LISTS);
         ~.
         ~.
    REMOVE_KEY_MAP (user$keymap_list, user$keymap_1, ALL);
         ~.
         ~.
    SHOW (KEY_MAP_LISTS);