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);