Version bump.
[xtoys] / xtell.1
1 .\" -*-nroff-*-
2 .TH xtell 1 "15 November 1998" "Edgeware tools"
3 .SH NAME
4 xtell \- prods a waiting xwait process
5 .SH SYNOPSIS
6 .ll +5i
7 .B xtell
8 .RB [ \-d
9 .IR display ]
10 .RB [ \-a
11 .IR atom ]
12 .RB [ \-m
13 .IR message ]
14 .RI [ \c
15 .IB atom : msg , msg \c
16 \&...]
17 .ll -5i
18 .SH DESCRIPTION
19 The
20 .B xtell
21 program sets a named property on the X root window to a particular
22 value. This is primarily useful for communicating with
23 .BR xwait (1).
24 .SS OPTIONS
25 .TP 5
26 .BI "\-d, \-\-display " display
27 Attempt to connect to
28 .I display
29 rather than the display named in the usual environment variable.
30 .TP 5
31 .BI "\-a, \-\-atom " atom
32 Sets
33 .B xtell
34 to to set the property named
35 .IR atom .
36 Use of this option is deprecated.
37 .TP 5
38 .BI "\-m, \-\-msg " message
39 Sets
40 .B xtell
41 to set the given property to
42 .IR message .
43 Use of this option is deprecated.
44 .PP
45 The
46 .B \-a
47 and
48 .B \-m
49 options are deprecated, though retained for compatibility reasons. It's
50 recommended that you use the non-option specification instead.
51 .PP
52 The argument specifies an atom name and a message string to set. The
53 default, if no atom or message is given, is to set
54 .B XWAIT_PROPERTY
55 to the value
56 .BR XWAIT_MESSAGE .
57 .SH AUTHOR
58 Mark Wooding (mdw@nsict.org).
59 .SH BUGS
60 None currently known.
61 .SH SEE ALSO
62 .BR xwait (1),
63 and
64 .BR xshutdown (1).