opensolaris man page for tkwait

tkwait(1T)						       Tk Built-In Commands							tkwait(1T)

__________________________________________________________________________________________________________________________________________________

NAME
       tkwait - Wait for variable to change or window to be destroyed

SYNOPSIS
       tkwait variable name

       tkwait visibility name

       tkwait window name
_________________________________________________________________

DESCRIPTION
       The tkwait command waits for one of several things to happen, then it returns without taking any other actions.	The return value is always
       an empty string.  If the first argument is variable (or any abbreviation of it) then the second argument is the name of a  global  variable
       and  the  command  waits for that variable to be modified.  If the first argument is visibility (or any abbreviation of it) then the second
       argument is the name of a window and the tkwait command waits for a change in its visibility state (as indicated by the arrival of a  Visi-
       bilityNotify event).  This form is typically used to wait for a newly-created window to appear on the screen before taking some action.	If
       the first argument is window (or any abbreviation of it) then the second argument is the name of a window and the tkwait command waits  for
       that  window  to  be  destroyed.   This	form is typically used to wait for a user to finish interacting with a dialog box before using the
       result of that interaction.

       While the tkwait command is waiting it processes events in the normal fashion, so the application will continue to respond to user interac-
       tions.  If an event handler invokes tkwait again, the nested call to tkwait must complete before the outer call can complete.

KEYWORDS
       variable, visibility, wait, window

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk																	tkwait(1T)