diff options
author | colin <colin@chinix.com> | 2016-08-10 04:27:22 (GMT) |
---|---|---|
committer | colin <colin@chinix.com> | 2016-08-10 04:27:22 (GMT) |
commit | ba79accb7f5d874b8ead5c08befd5089507fe930 (patch) | |
tree | 53dd44241bb61baf996ccafd5844f236aef24021 /doc | |
parent | 110c6ce3c794ed5ba705289ce6a4850fcb25f044 (diff) | |
download | tcl-ba79accb7f5d874b8ead5c08befd5089507fe930.zip tcl-ba79accb7f5d874b8ead5c08befd5089507fe930.tar.gz tcl-ba79accb7f5d874b8ead5c08befd5089507fe930.tar.bz2 |
* added some docco for [update] changes.updateextended
Diffstat (limited to 'doc')
-rw-r--r-- | doc/update.n | 16 |
1 files changed, 13 insertions, 3 deletions
diff --git a/doc/update.n b/doc/update.n index ce0fb25..9e1ab4b 100644 --- a/doc/update.n +++ b/doc/update.n @@ -12,14 +12,14 @@ .SH NAME update \- Process pending events and idle callbacks .SH SYNOPSIS -\fBupdate\fR ?\fBidletasks\fR? +\fBupdate\fR ?\fIoption ...\fR? .BE .SH DESCRIPTION .PP This command is used to bring the application .QW "up to date" by entering the event loop repeatedly until all pending events -(including idle callbacks) have been processed. +(including idle callbacks, if specified) have been processed. .PP If the \fBidletasks\fR keyword is specified as an argument to the command, then no new events or errors are processed; only idle @@ -27,6 +27,16 @@ callbacks are invoked. This causes operations that are normally deferred, such as display updates and window layout calculations, to be performed immediately. .PP +Options accepted are + \fBidletasks\fR - process any pending window events or idle events, do not wait + \fBwindow\fR - process window events + \fBfile\fR - process file events + \fBtimer\fR - process timer events + \fBonlyidle\fR - process only idle events + \fBall\fR - process all events + \fBwait\fR - wait until at least one event has been processed + \fBnowait\fR - return immediately if no events are pending. +.PP The \fBupdate idletasks\fR command is useful in scripts where changes have been made to the application's state and you want those changes to appear on the display immediately, rather than waiting @@ -60,6 +70,6 @@ while {!$done} { } .CE .SH "SEE ALSO" -after(n), interp(n) +after(n), interp(n), Tcl_DoOneEvent(3) .SH KEYWORDS asynchronous I/O, event, flush, handler, idle, update |