4 \h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
9 .TH xwait 1 "15 November 1998" "Straylight/Edgeware" "xtoys"
11 xwait \- wait until prodded by another X client
23 .IB atom : msg , msg \c
29 program waits until it notices that a particular property on the X root
30 window has been assigned a particular value, at which point the program
31 exits. The property can be set using the
35 programs. It's mostly useful for putting at the end of a user's
37 file, so that it can be triggered to end the session.
39 The properties, and the values to listen for, can be configured at the
42 exits, it removes the properties from the root window.
48 to start up, even though there may be an existing process already
49 listening for the particular atom in question.
51 .BI "\-d, \-\-display " display
54 rather than the display named in the usual environment variable.
56 .BI "\-a, \-\-atom " atom
59 to listen for the property named
61 Use of this option is deprecated.
63 .BI "\-m, \-\-msg " msg
66 to wait for the given property to be set to
68 Use of this option is deprecated.
74 options are deprecated, though retained for compatibility reasons.
75 It's recommended that you use the non-option specification instead.
77 Each argument specifies an atom name and a list of message strings to
78 listen to. Multiple properties may be listened for, and multiple
79 messages may be accepted for each property. If no messages are
80 specified then all values are considered to be acceptable. The program
81 exits when any property is set to an acceptable value.
83 If no atoms are given on the command line,
90 When a message is eventually received,
92 prints information about it to standard output:
94 If more than one property (atom) was specified, the property name is
97 If more than one message is recognized for the property, the message
98 string is printed; if a property name was printed, the two are separated
99 by a colon and a single space character.
102 then exits with return code 0.
104 Mark Wooding (mdw@nsict.org).
106 None currently known.