Release 1.6.0.

[xtoys] / xcatch.1

diff --git a/xcatch.1 b/xcatch.1
index bdd953b..c7ae65f 100644 (file)
--- a/xcatch.1
+++ b/xcatch.1
@@ -1,13 +1,14 @@
 .\" -*-nroff-*-
-.TH xcatch 1 "15 December 1998" "Edgeware tools"
+.TH xcatch 1 "15 December 1998" "Straylight/Edgeware" "xtoys"
 .SH NAME
 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.
-.SS OPTIONS
+.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 AUTHOR
-Mark Wooding (mdw@nsict.org).
 .SH BUGS
 None currently known.
+.SH SEE ALSO
+.BR gtk-options (7).
+.SH AUTHOR
+Mark Wooding (mdw@distorted.org.uk).