Release 1.6.0.

[xtoys] / xcatch.1

diff --git a/xcatch.1 b/xcatch.1
index 34bb62b..c7ae65f 100644 (file)
--- a/xcatch.1
+++ b/xcatch.1
@@ -4,10 +4,11 @@
 xcatch \- catch input and trap it in a window
 .SH SYNOPSIS
 .B xcatch
-.RB [ \-f
-.IR file ]
+.RI [ gtk-options ...]
 .RB [ \-F
 .IR font ]
+.RB [ \-f
+.IR file ]
 .RI [ command
 .RI [ args ]...]
 .SH DESCRIPTION
@@ -26,22 +27,39 @@ redirected to
 otherwise,
 .B xcatch
 reads from its own standard input.
+.PP
+It is better to write
+.IP
+.B xcatch
+.I command args
+.PP
+than
+.IP
+.I command args
+.B | xcatch
+.PP
+The former allows
+.B xcatch
+to collect the exit status of the
+.I command
+and (a) report it in its window, and (b) provide it (or a version of it)
+as its own exit status for the caller to check.  It also enables
+.B xcatch
+to put the command line in its title bar.
 .SS Options
 .TP
-.BI "\-\-display " display
-Create the window on the named
-.IR display .
+.BI "\-F, \-\-font " font
+Display output text in
+.I font
+rather than GTK's default.
 .TP
 .BI "\-f, \-\-file " file
 Read data from
 .I file
 instead of standard output.
-.TP
-.BI "\-F, \-\-font " font
-Display output text in 
-.I font
-rather than GTK's default (Helvetica).
 .SH BUGS
 None currently known.
+.SH SEE ALSO
+.BR gtk-options (7).
 .SH AUTHOR
 Mark Wooding (mdw@distorted.org.uk).