From: Richard M. Stallman <rms@gnu.org>
Date: Wed, 5 Jul 2006 17:07:29 +0000 (+0000)
Subject: (Changing Key Bindings): Cleanup.
X-Git-Tag: emacs-pretest-22.0.90~1680
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=fc0804c44752e4d7bb878ccdb77952dbca07ec79;p=emacs.git

(Changing Key Bindings): Cleanup.
Add xref to Key Binding Conventions.
---

diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi
index f6779b247d0..ed03a1fc90d 100644
--- a/lispref/keymaps.texi
+++ b/lispref/keymaps.texi
@@ -1198,6 +1198,10 @@ convenient interfaces for these operations (@pxref{Key Binding
 Commands}).  You can also use @code{define-key}, a more general
 function; then you must specify explicitly the map to change.
 
+  When choosing the key sequences for Lisp programs to rebind, please
+follow the Emacs conventions for use of various keys (@pxref{Key
+Binding Conventions}).
+
 @cindex meta character key constants
 @cindex control character key constants
   In writing the key sequence to rebind, it is good to use the special
@@ -1219,11 +1223,11 @@ key name).  For example, @code{(control ?a)} is equivalent to
 @code{C-H-left}.  One advantage of such lists is that the precise
 numeric codes for the modifier bits don't appear in compiled files.
 
-  For the functions below, an error is signaled if @var{keymap} is not
-a keymap or if @var{key} is not a string or vector representing a key
-sequence.  You can use event types (symbols) as shorthand for events
-that are lists.  The @code{kbd} macro (@pxref{Key Sequences}) is a
-convenient way to specify the key sequence.
+  The functions below signal an error if @var{keymap} is not a keymap,
+or if @var{key} is not a string or vector representing a key sequence.
+You can use event types (symbols) as shorthand for events that are
+lists.  The @code{kbd} macro (@pxref{Key Sequences}) is a convenient
+way to specify the key sequence.
 
 @defun define-key keymap key binding
 This function sets the binding for @var{key} in @var{keymap}.  (If