From: Kim F. Storm <storm@cua.dk>
Date: Tue, 26 Oct 2004 12:55:51 +0000 (+0000)
Subject: (Interactive Codes): Add U code letter.
X-Git-Tag: ttn-vms-21-2-B4~4395
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3baa952d8bd2d0ad1587440a559ae10616ea2a4e;p=emacs.git

(Interactive Codes): Add U code letter.
---

diff --git a/lispref/commands.texi b/lispref/commands.texi
index 299c7bb61af..cb772ff6eb5 100644
--- a/lispref/commands.texi
+++ b/lispref/commands.texi
@@ -360,6 +360,9 @@ until a command (or undefined command) is found in the current key
 maps.  The key sequence argument is represented as a string or vector.
 The cursor does not move into the echo area.  Prompt.
 
+If the key sequence is a down-event, the following up-event is discarded,
+but can be read via the @code{U} code character.
+
 This kind of input is used by commands such as @code{describe-key} and
 @code{global-set-key}.
 
@@ -416,6 +419,11 @@ character terminates the input.  (Use @kbd{C-q} to include whitespace in
 the string.)  Other characters that normally terminate a symbol (e.g.,
 parentheses and brackets) do not do so here.  Prompt.
 
+@item U
+A key sequence or nil.  May be used after a @code{k} or @code{K}
+argument to get the up-event that was discarded in case the key
+sequence read for that argument was a down-event.  No I/O.
+
 @item v
 A variable declared to be a user option (i.e., satisfying the
 predicate @code{user-variable-p}).  This reads the variable using