# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1153937934 0
# Node ID 8eab314cd76ecd2bd9e137f8a87f7442012ba9fa
# Parent  0d8b226a4a76af504342e9f354b5af96eabfbd68
	* commands.texi (Reading One Event): Document SECONDS argument for
	read-event, read-char, and read-char-exclusive.

diff -r 0d8b226a4a76 -r 8eab314cd76e lispref/ChangeLog
--- a/lispref/ChangeLog	Wed Jul 26 18:18:26 2006 +0000
+++ b/lispref/ChangeLog	Wed Jul 26 18:18:54 2006 +0000
@@ -1,3 +1,8 @@
+2006-07-26  Chong Yidong  <cyd@stupidchicken.com>
+
+	* commands.texi (Reading One Event): Document SECONDS argument for
+	read-event, read-char, and read-char-exclusive.
+
 2006-07-25  Stefan Monnier  <monnier@iro.umontreal.ca>
 
 	* modes.texi (Multiline Font Lock): Can't use jit-lock-defer-multiline
diff -r 0d8b226a4a76 -r 8eab314cd76e lispref/commands.texi
--- a/lispref/commands.texi	Wed Jul 26 18:18:26 2006 +0000
+++ b/lispref/commands.texi	Wed Jul 26 18:18:54 2006 +0000
@@ -2199,7 +2199,7 @@
 
 None of the three functions below suppresses quitting.
 
-@defun read-event &optional prompt inherit-input-method
+@defun read-event &optional prompt inherit-input-method seconds
 This function reads and returns the next event of command input, waiting
 if necessary until an event is available.  Events can come directly from
 the user or from a keyboard macro.
@@ -2220,6 +2220,15 @@
 moves the cursor temporarily to the echo area, to the end of any message
 displayed there.  Otherwise @code{read-event} does not move the cursor.
 
+If @code{seconds} is non-@code{nil}, it should be a number specifying
+the maximum time to wait for input, in seconds.  If no input arrives
+within that time, @code{read-event} stops waiting and returns
+@code{nil}.  A floating-point value for @code{seconds} means to wait
+for a fractional number of seconds.  Some systems support only a whole
+number of seconds; on these systems, @code{seconds} is rounded down.
+If @code{seconds} is @code{nil}, @code{read-event} waits as long as
+necessary for input to arrive.
+
 If @code{read-event} gets an event that is defined as a help character,
 then in some cases @code{read-event} processes the event directly without
 returning.  @xref{Help Functions}.  Certain other events, called
@@ -2237,7 +2246,7 @@
 @end example
 @end defun
 
-@defun read-char &optional prompt inherit-input-method
+@defun read-char &optional prompt inherit-input-method seconds
 This function reads and returns a character of command input.  If the
 user generates an event which is not a character (i.e. a mouse click or
 function key event), @code{read-char} signals an error.  The arguments
@@ -2269,7 +2278,7 @@
 @end example
 @end defun
 
-@defun read-char-exclusive &optional prompt inherit-input-method
+@defun read-char-exclusive &optional prompt inherit-input-method seconds
 This function reads and returns a character of command input.  If the
 user generates an event which is not a character,
 @code{read-char-exclusive} ignores it and reads another event, until it