comparison lispref/commands.texi @ 71777:5fb29ee9d9aa

(Waiting): (sit-for -1) is no longer special. (sit-for 0) is equivalent to (redisplay). Iconifying/deiconifying no longer makes sit-for return.

71776:93e3d16a8207

The argument @var{seconds} need not be an integer.  If it is a floating
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}.

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.

It is also possible to call @code{sit-for} with three arguments,

71777:5fb29ee9d9aa

The argument @var{seconds} need not be an integer.  If it is a floating
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.

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).

The usual purpose of @code{sit-for} is to give the user time to read
text that you display.

It is also possible to call @code{sit-for} with three arguments,