# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1112043954 0
# Node ID a45405053cb1817a7a67698de95a941380b5a3cb
# Parent  71da083fd001711cf05c819989a5d1b164f75d58
(Function Keys): Document kp- event types and keypad-setup package.

diff -r 71da083fd001 -r a45405053cb1 man/custom.texi
--- a/man/custom.texi	Mon Mar 28 21:04:39 2005 +0000
+++ b/man/custom.texi	Mon Mar 28 21:05:54 2005 +0000
@@ -1636,6 +1636,27 @@
 (global-set-key [H-M-right] 'forward-word)
 @end example
 
+@cindex keypad
+  Many keyboards have a ``numeric keypad'' on the right hand side.
+The numeric keys in the keypad double up as cursor motion keys,
+toggled by a key labelled @samp{Num Lock}.  By default, Emacs
+translates these keys to the corresponding keys in the main keyboard
+(@pxref{Keyboard Translations}).  For example, when @samp{Num Lock} is
+on, the key labelled @samp{8} on the numeric keypad produces
+@code{kp-8}, which is translated to @kbd{8}; when @samp{Num Lock} is
+off, the same key produces @code{kp-up}, which is translated to
+@key{UP}.  If you rebind a key such as @kbd{8} or @key{UP}, it affects
+the equivalent keypad key too.  However, if you rebind a @samp{kp-}
+key directly, that won't affect its non-keypad equivalent.
+
+  Emacs provides a convenient method for binding the numeric keypad
+keys, using the variables @code{keypad-setup},
+@code{keypad-numlock-setup}, @code{keypad-shifted-setup}, and
+@code{keypad-numlock-shifted-setup}.  These can be found in the
+@samp{keyboard} customization group (@pxref{Easy Customization}).  You
+can rebind the keys to perform other tasks, such as issuing numeric
+prefix arguments.
+
 @node Named ASCII Chars
 @subsection Named @acronym{ASCII} Control Characters