From 2b83bc4334bf7c85c553e67d4c86a86b3379b9b5 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Fri, 20 Jan 2006 01:24:33 +0000 Subject: (Key Sequence Input): Clarify. Move num-nonmacro-input-events out. (Reading One Event): num-nonmacro-input-events moved here. --- lispref/commands.texi | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) (limited to 'lispref/commands.texi') diff --git a/lispref/commands.texi b/lispref/commands.texi index ed9cb2cf3ca..0d5e8b232ff 100644 --- a/lispref/commands.texi +++ b/lispref/commands.texi @@ -2074,6 +2074,9 @@ Otherwise, it returns a vector, since a vector can hold all kinds of events---characters, symbols, and lists. The elements of the string or vector are the events in the key sequence. +Reading a key sequence includes translating the events in various +ways. @xref{Translating Input}. + The argument @var{prompt} is either a string to be displayed in the echo area as a prompt, or @code{nil}, meaning not to display a prompt. The argument @var{continue-echo}, if non-@code{nil}, means to echo @@ -2097,8 +2100,8 @@ key sequence is being read by something that will read commands one after another. It should be @code{nil} if the caller will read just one key sequence. -In the example below, the prompt @samp{?} is displayed in the echo area, -and the user types @kbd{C-x C-f}. +In the following example, Emacs displays the prompt @samp{?} in the +echo area, and then the user types @kbd{C-x C-f}. @example (read-key-sequence "?") @@ -2173,11 +2176,6 @@ this Emacs session. This includes key sequences read from the terminal and key sequences read from keyboard macros being executed. @end defvar -@defvar num-nonmacro-input-events -This variable holds the total number of input events received so far -from the terminal---not counting those generated by keyboard macros. -@end defvar - @node Reading One Event @subsection Reading One Event @cindex reading a single event @@ -2265,6 +2263,11 @@ user generates an event which is not a character, gets a character. The arguments work as in @code{read-event}. @end defun +@defvar num-nonmacro-input-events +This variable holds the total number of input events received so far +from the terminal---not counting those generated by keyboard macros. +@end defvar + @node Invoking the Input Method @subsection Invoking the Input Method -- cgit v1.2.1