changeset 59057:92202f639066

(Event Input Misc): Add while-no-input.
author Richard M. Stallman <rms@gnu.org>
date Tue, 21 Dec 2004 11:46:47 +0000
parents 956483cc3659
children 54f8cd81210b
files lispref/commands.texi
diffstat 1 files changed, 12 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/commands.texi	Tue Dec 21 11:38:36 2004 +0000
+++ b/lispref/commands.texi	Tue Dec 21 11:46:47 2004 +0000
@@ -2388,6 +2388,18 @@
 Emacs version 18.
 @end defvar
 
+@defmac while-no-input body...
+This construct runs the @var{body} forms and returns the value
+of the last one---but only if no input arrives.  If any input
+arrives during the execution of the @var{body} forms, it aborts
+them (working much like a quit), and the @code{while-no-input}
+form returns @code{nil}.
+
+If a part of @var{body} binds @code{inhibit-quit} to non-@code{nil},
+arrival of input during those parts won't cause an abort until
+the end of that part.
+@end defmac
+
 @defun discard-input
 @cindex flush input
 @cindex discard input