(Waiting): (sit-for -1) is no longer special.

(sit-for 0) is equivalent to (redisplay).
Iconifying/deiconifying no longer makes sit-for return.
This commit is contained in:
Kim F. Storm 2006-07-11 00:47:53 +00:00
parent a4df70f7df
commit 9ae011ae3b

View file

@ -2543,19 +2543,14 @@ point number, @code{sit-for} waits for a fractional number of seconds.
Some systems support only a whole number of seconds; on these systems,
@var{seconds} is rounded down.
If @var{seconds} is negative, force a redisplay even if there is
pending input. So use @code{(sit-for -1)} to force a redisplay.
The expression @code{(sit-for 0)} is a convenient way to request a
redisplay, without any delay, if there is no pending input. @xref{Forcing Redisplay}.
The expression @code{(sit-for 0)} is equivalent to @code{(redisplay)},
i.e. it requests a redisplay, without any delay, if there is no pending input.
@xref{Forcing Redisplay}.
If @var{nodisp} is non-@code{nil}, then @code{sit-for} does not
redisplay, but it still returns as soon as input is available (or when
the timeout elapses).
Iconifying or deiconifying a frame makes @code{sit-for} return, because
that generates an event. @xref{Misc Events}.
The usual purpose of @code{sit-for} is to give the user time to read
text that you display.