From: Richard M. Stallman <rms@gnu.org>
Date: Wed, 8 Feb 2006 00:26:37 +0000 (+0000)
Subject: (Key Lookup): Clarify wrt commands vs other functions.
X-Git-Tag: emacs-pretest-22.0.90~4296
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=91055930f5260b0d5e36e8512f209b9cc211c8b8;p=emacs.git

(Key Lookup): Clarify wrt commands vs other functions.
(Changing Key Bindings): Clarify when remapping is better than
substitute-key-definition.
---

diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi
index f73f8d3b7a4..b7bc34ece84 100644
--- a/lispref/keymaps.texi
+++ b/lispref/keymaps.texi
@@ -933,8 +933,10 @@ is a keymap, and is treated as a keymap (see above).
 @item
 @cindex @code{lambda} in keymap
 If the @sc{car} of @var{list} is @code{lambda}, then the list is a
-lambda expression.  This is presumed to be a command, and is treated as
-such (see above).
+lambda expression.  This is presumed to be a function, and is treated
+as such (see above).  In order to execute properly as a key binding,
+this function must be a command---it must have an @code{interactive}
+specification.  @xref{Defining Commands}.
 
 @item
 If the @sc{car} of @var{list} is a keymap and the @sc{cdr} is an event
@@ -1282,9 +1284,9 @@ default global map.
 
   The function @code{substitute-key-definition} scans a keymap for
 keys that have a certain binding and rebinds them with a different
-binding.  Another feature you can use for similar effects, but which
-is often cleaner, is to add a binding that remaps a command
-(@pxref{Remapping Commands}).
+binding.  Another feature which is cleaner and can often produce the
+same results to remap one command into another (@pxref{Remapping
+Commands}).
 
 @defun substitute-key-definition olddef newdef keymap &optional oldmap
 @cindex replace bindings