changeset 71776:93e3d16a8207

(Forcing Redisplay): Add `redisplay' function. Don't mention (sit-for -1) -- use (redisplay t) instead.
author Kim F. Storm <storm@cua.dk>
date Tue, 11 Jul 2006 00:47:42 +0000
parents dbb73e0b716b
children 5fb29ee9d9aa
files lispref/display.texi
diffstat 1 files changed, 7 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/display.texi	Tue Jul 11 00:17:43 2006 +0000
+++ b/lispref/display.texi	Tue Jul 11 00:47:42 2006 +0000
@@ -113,10 +113,13 @@
 regardless of whether input is available.
 @end defvar
 
-@findex sit-for
-  You can request a display update, but only if no input is pending,
-with @code{(sit-for 0)}.  To force a display update even when input is
-pending, use @code{(sit-for -1)}.
+@defun redisplay &optional force
+This function performs an immediate redisplay provided there are no
+pending input events.  This is equivalent to @code{(sit-for 0)}.
+
+If the optional argument @var{force} is non-@code{nil}, it forces an
+immediate and complete redisplay even if input is available.
+@end defun
 
 @node Truncation
 @section Truncation