New command line syntax, and new atom protocol.

[xtoys] / xtell.1

diff --git a/xtell.1 b/xtell.1
index 3329537..2fd32a9 100644 (file)
--- a/xtell.1
+++ b/xtell.1
@@ -3,6 +3,7 @@
 .SH NAME
 xtell \- prods a waiting xwait process
 .SH SYNOPSIS
+.ll +5i
 .B xtell
 .RB [ \-d
 .IR display ]
@@ -10,6 +11,10 @@ xtell \- prods a waiting xwait process
 .IR atom ]
 .RB [ \-m
 .IR message ]
+.RI [ \c
+.IB atom : msg , msg \c
+\&...]
+.ll -5i
 .SH DESCRIPTION
 The
 .B xtell
@@ -28,15 +33,26 @@ Sets
 .B xtell
 to to set the property named
 .IR atom .
-The default property to set to is
-.BR XWAIT_PROPERTY .
+Use of this option is deprecated.
 .TP 5
 .BI "\-m, \-\-msg " message
 Sets
 .B xtell
 to set the given property to
 .IR message .
-The default message to set is
+Use of this option is deprecated.
+.PP
+The
+.B \-a
+and
+.B \-m
+options are deprecated, though retained for compatibility reasons.  It's
+recommended that you use the non-option specification instead.
+.PP
+The argument specifies an atom name and a message string to set.  The
+default, if no atom or message is given, is to set
+.B XWAIT_PROPERTY
+to the value
 .BR XWAIT_MESSAGE .
 .SH AUTHOR
 Mark Wooding (mdw@nsict.org).