From: Kim F. Storm <storm@cua.dk>
Date: Tue, 11 Jul 2006 00:47:42 +0000 (+0000)
Subject: (Forcing Redisplay): Add `redisplay' function.
X-Git-Tag: emacs-pretest-22.0.90~1560
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a4df70f7df56f20168b56172e4bcdd6937751708;p=emacs.git

(Forcing Redisplay): Add `redisplay' function.
Don't mention (sit-for -1) -- use (redisplay t) instead.
---

diff --git a/lispref/display.texi b/lispref/display.texi
index 567b9931b48..701957c8ad5 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -113,10 +113,13 @@ prevent or halt redisplay; redisplay occurs, and finishes,
 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