]> code.delx.au - gnu-emacs/commitdiff
(Command Loop Info): Explain how read-event affects this-command-keys.
authorRichard M. Stallman <rms@gnu.org>
Sun, 24 Sep 2006 20:33:29 +0000 (20:33 +0000)
committerRichard M. Stallman <rms@gnu.org>
Sun, 24 Sep 2006 20:33:29 +0000 (20:33 +0000)
lispref/commands.texi

index 514b55205a1ef1f9f8ed89d73f93c1a9c0eb643c..e27488964d0e094c9bda14258a8304985505bb7f 100644 (file)
@@ -788,11 +788,13 @@ was specified to run but remapped into another command.
 @anchor{Definition of this-command-keys}
 This function returns a string or vector containing the key sequence
 that invoked the present command, plus any previous commands that
-generated the prefix argument for this command.  However, if the
-command has called @code{read-key-sequence}, it returns the last read
-key sequence.  @xref{Key Sequence Input}.  The value is a string if
-all events in the sequence were characters that fit in a string.
-@xref{Input Events}.
+generated the prefix argument for this command.  Any events read by the
+command using @code{read-event} without a timeout get tacked on to the end.
+
+However, if the command has called @code{read-key-sequence}, it
+returns the last read key sequence.  @xref{Key Sequence Input}.  The
+value is a string if all events in the sequence were characters that
+fit in a string.  @xref{Input Events}.
 
 @example
 @group