summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorcolin <colin@chinix.com>2016-08-10 04:27:22 (GMT)
committercolin <colin@chinix.com>2016-08-10 04:27:22 (GMT)
commitba79accb7f5d874b8ead5c08befd5089507fe930 (patch)
tree53dd44241bb61baf996ccafd5844f236aef24021
parent110c6ce3c794ed5ba705289ce6a4850fcb25f044 (diff)
downloadtcl-updateextended.zip
tcl-updateextended.tar.gz
tcl-updateextended.tar.bz2
* added some docco for [update] changes.updateextended
-rw-r--r--doc/update.n16
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