diff options
| author | Kim F. Storm | 2006-07-11 00:47:53 +0000 |
|---|---|---|
| committer | Kim F. Storm | 2006-07-11 00:47:53 +0000 |
| commit | 9ae011ae3b30bfc85a891e8c9d1daa8425bbbabf (patch) | |
| tree | aece102f3d69f904d7650cafaa12812e982b3d28 | |
| parent | a4df70f7df56f20168b56172e4bcdd6937751708 (diff) | |
| download | emacs-9ae011ae3b30bfc85a891e8c9d1daa8425bbbabf.tar.gz emacs-9ae011ae3b30bfc85a891e8c9d1daa8425bbbabf.zip | |
(Waiting): (sit-for -1) is no longer special.
(sit-for 0) is equivalent to (redisplay).
Iconifying/deiconifying no longer makes sit-for return.
| -rw-r--r-- | lispref/commands.texi | 11 |
1 files changed, 3 insertions, 8 deletions
diff --git a/lispref/commands.texi b/lispref/commands.texi index c6f3fcf39b2..2aca1b19253 100644 --- a/lispref/commands.texi +++ b/lispref/commands.texi | |||
| @@ -2543,19 +2543,14 @@ point number, @code{sit-for} waits for a fractional number of seconds. | |||
| 2543 | Some systems support only a whole number of seconds; on these systems, | 2543 | Some systems support only a whole number of seconds; on these systems, |
| 2544 | @var{seconds} is rounded down. | 2544 | @var{seconds} is rounded down. |
| 2545 | 2545 | ||
| 2546 | If @var{seconds} is negative, force a redisplay even if there is | 2546 | The expression @code{(sit-for 0)} is equivalent to @code{(redisplay)}, |
| 2547 | pending input. So use @code{(sit-for -1)} to force a redisplay. | 2547 | i.e. it requests a redisplay, without any delay, if there is no pending input. |
| 2548 | 2548 | @xref{Forcing Redisplay}. | |
| 2549 | The expression @code{(sit-for 0)} is a convenient way to request a | ||
| 2550 | redisplay, without any delay, if there is no pending input. @xref{Forcing Redisplay}. | ||
| 2551 | 2549 | ||
| 2552 | If @var{nodisp} is non-@code{nil}, then @code{sit-for} does not | 2550 | If @var{nodisp} is non-@code{nil}, then @code{sit-for} does not |
| 2553 | redisplay, but it still returns as soon as input is available (or when | 2551 | redisplay, but it still returns as soon as input is available (or when |
| 2554 | the timeout elapses). | 2552 | the timeout elapses). |
| 2555 | 2553 | ||
| 2556 | Iconifying or deiconifying a frame makes @code{sit-for} return, because | ||
| 2557 | that generates an event. @xref{Misc Events}. | ||
| 2558 | |||
| 2559 | The usual purpose of @code{sit-for} is to give the user time to read | 2554 | The usual purpose of @code{sit-for} is to give the user time to read |
| 2560 | text that you display. | 2555 | text that you display. |
| 2561 | 2556 | ||