Build system overhaul and spring cleaning.
[xtoys] / xcatch.1
CommitLineData
b6eb57e6 1.\" -*-nroff-*-
ec19d7af 2.TH xcatch 1 "15 December 1998" "Straylight/Edgeware" "xtoys"
63351ac6 3.SH NAME
4xcatch \- catch input and trap it in a window
5.SH SYNOPSIS
6.B xcatch
7.RB [ \-f
8.IR file ]
9.RB [ \-F
10.IR font ]
11.RI [ command
12.RI [ args ]...]
13.SH DESCRIPTION
14The
15.B xcatch
16program watches an input file descriptor (usually a pipe) and displays
17data from it in a GTK window. The window is displayed only when data is
18first read from the descriptor; if no data ever arrives, the window is
19not created. If a file is specified using the
20.B \-f
21option, it is read; otherwise, if a
22.I command
23is specified, it is executed with standard output and standard error
24redirected to
25.BR xcatch ;
26otherwise,
27.B xcatch
28reads from its own standard input.
e571b0f1 29.SS Options
63351ac6 30.TP
31.BI "\-\-display " display
32Create the window on the named
33.IR display .
34.TP
35.BI "\-f, \-\-file " file
36Read data from
37.I file
38instead of standard output.
39.TP
40.BI "\-F, \-\-font " font
41Display output text in
42.I font
43rather than GTK's default (Helvetica).
63351ac6 44.SH BUGS
45None currently known.
f6795c17
MW
46.SH AUTHOR
47Mark Wooding (mdw@distorted.org.uk).