X-Git-Url: https://git.distorted.org.uk/~mdw/xtoys/blobdiff_plain/90b2c5d453c6e561a00913baa7aa8b9c213f0173..deeda4493d36aac9f6c4b45e8085767c29ccd498:/xwait.1

diff --git a/xwait.1 b/xwait.1
index f9b9ccb..4c09801 100644
--- a/xwait.1
+++ b/xwait.1
@@ -1,15 +1,21 @@
+.\" -*-nroff-*-
 .TH xwait 1 "15 November 1998" "Edgeware tools"
 .SH NAME
 xwait \- wait until prodded by another X client
 .SH SYNOPSIS
+.ll +5i
 .B xwait
-.RI [ \-f ]
+.RB [ \-f ]
 .RB [ \-d
 .IR display ]
 .RB [ \-a
 .IR atom ]
 .RB [ \-m
 .IR message ]
+.RI [ \c
+.IB atom : msg , msg \c
+\&...]
+.ll -5i
 .SH DESCRIPTION
 The
 .B xwait
@@ -23,37 +29,55 @@ programs.  It's mostly useful for putting at the end of a user's
 .B .xinitrc
 file, so that it can be triggered to end the session.
 .PP
-The property, and the value to listen for, can be configured at
-the command line.  When
+The properties, and the values to listen for, can be configured at the
+command line.  When
 .B xwait
-exits, it removes the property from the root window.
+exits, it removes the properties from the root window.
 .SS OPTIONS
 .TP 5
-.B \-f
+.B \-f, \-\-force
 Force 
 .B xwait
 to start up, even though there may be an existing process already
 listening for the particular atom in question.
 .TP 5
-.BI "\-d " display
+.BI "\-d, \-\-display " display
 Attempt to connect to
 .I display
 rather than the display named in the usual environment variable.
 .TP 5
-.BI "\-a " atom
+.BI "\-a, \-\-atom " atom
 Sets
 .B xwait
 to listen for the property named
 .IR atom .
-The default property to listen to is
-.BR XWAIT_PROPERTY .
+Use of this option is deprecated.
 .TP 5
-.BI "\-m " message
+.BI "\-m, \-\-msg " message
 Sets
 .B xwait
 to wait for the given property to be set to
 .IR message .
-The default message to wait for is
+Use of this option is deprecated.
+.SS "Argument format"
+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
+Each argument specifies an atom name and a list of message strings to
+listen to.  Multiple properties may be listened for, and multiple
+messages may be accepted for each property.  If no messages are
+specified then all values are considered to be acceptable.  The program
+exits when any property is set to an acceptable value.
+.PP
+If no atoms are given on the command line,
+.B xwait
+will wait for
+.B XWAIT_PROPERTY
+to be set to
 .BR XWAIT_MESSAGE .
 .SH AUTHOR
 Mark Wooding (mdw@nsict.org).