Re: Function for deleting a key binding in a sparse keymap

[Lennart Borgman <lennart.borgman.073@student.lu.se>]

Richard M. Stallman wrote:

>    *****************************************************************************
>    How to find the keymap for a given key sequence in a buffer
>    ===========================================================
>
>It would be good to put this list into the Active Keymaps node
>in lispref/keymaps.texi.
>  
>
I am glad you appreciate it. However there was a bit more to add. I got 
some tips from Kim and made a new version. There is a question in this 
about when the keymap entry is a keymap.

*********************************************************************************

*****************************************************************************
How to find the keymap for a given key sequence in a buffer
===========================================================

Go through the list below step by step. As soon as a hit is found in
any keymap (see KeyLookup) you normally are ready. However if the
keymap entry is a variable symbol or a string then you must restart
with the variable symbol value or the string from FIRST-MAP.

The keymap entry could also be a keymap. In that case the next event
is looked up in that keymap. (But what happens if there is no hit
there, I can not find any documentation on this???)

Note: When you finally find a function symbol through this process you
   must also check for command remapping. This just replaces the
   function symbol with another. It is not recursive.

*) First apply `extra-keyboard-modifiers' mask to each keyboard
   character read.

*) Each character read from the keyboard may be translated according
   to `keyboard-translate-table'.

*) Characters that are self-inserting are translated according to
   `translation-table-for-input'. If a character is self-inserting then
   you are ready.

*) Translate meta characters according to `meta-prefix-char' to a two
   character sequence.

FIRST-MAP) Look in `special-event-map'.

*) If using `read-from-minibuffer' (directly or indirectly) then look
   in the keymap given as parameter then look in this. Otherwise look
   in `minibuffer-local-map'.

*) If using `read-no-blanks-input' to read from minibuffer then look
   in `minibuffer-local-ns-map' first and then `minibuffer-local-map'.

*) If overriding-terminal-local-map look in this. Then go to GLOBAL.

*) If overriding-local-map look in this. Then go to GLOBAL.

*) Is there a "keymap" property of the text or overlay at point?

*) Look for minor mode keymaps in `emulation-mode-map-alists'.

*) Look for minor mode keymaps in `minor-mode-overriding-map-alist'

*) Look for minor mode keymaps in `minor-mode-map-alist'.

*) Is there a `local-map' property of the text or overlay at point?

*) Is there a "local keymap" (those are for major modes)?

GLOBAL) Look in the "current global keymap". (This is returned by
   `current-global-map' and may be different from `global-map', see
   `use-global-map'.)

*) If it is an ASCII function key sequences then look in
   function-key-map. This map transforms to Emacs key sequences.

*) The possibly transformed sequence after applying `function-key-map'
   is now handled to `key-translation-map' which works the same way.

*) If any transformation was made by `function-key-map' or
   `key-translation-map' then take the new sequence and go back to
   FIRST-MAP.

Note: You may also find the function `current-active-maps' useful.