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