Re: Using multiple minor-mode keymaps.

[Richard Stallman]

The `keymap' property is used for overriding just *part* of the local
map.  For most uses, `keymap' is better.  I am not sure if there is
still any good reason to use `local-map'.

I rewrote the text in the manual as follows:

@item keymap
@cindex keymap of character
@kindex keymap @r{(text property)}
The @code{keymap} property specifies an additional keymap for
commands.  The property's value for the character after point, if
address@hidden, is used for key lookup before the buffer's local map.
(For mouse clicks, the @code{keymap} property of the character clicked
on is the one used.)  If the property value is a symbol, the symbol's
function definition is used as the keymap.  @xref{Active Keymaps}.

@item local-map
@kindex local-map @r{(text property)}
This property specifies a keymap to use @emph{instead of} the buffer's
local map.  If the property value is a symbol, the symbol's function
definition is used as the keymap.  For most purposes (perhaps all
purposes), the @code{keymap} is superior.