Commit | Line | Data |
---|---|---|
b6eb57e6 | 1 | .\" -*-nroff-*- |
ec19d7af | 2 | .TH xcatch 1 "15 December 1998" "Straylight/Edgeware" "xtoys" |
63351ac6 | 3 | .SH NAME |
4 | xcatch \- catch input and trap it in a window | |
5 | .SH SYNOPSIS | |
6 | .B xcatch | |
bce8c6ee | 7 | .RI [ gtk-options ...] |
63351ac6 | 8 | .RB [ \-F |
9 | .IR font ] | |
bce8c6ee MW |
10 | .RB [ \-f |
11 | .IR file ] | |
63351ac6 | 12 | .RI [ command |
13 | .RI [ args ]...] | |
14 | .SH DESCRIPTION | |
15 | The | |
16 | .B xcatch | |
17 | program watches an input file descriptor (usually a pipe) and displays | |
18 | data from it in a GTK window. The window is displayed only when data is | |
19 | first read from the descriptor; if no data ever arrives, the window is | |
20 | not created. If a file is specified using the | |
21 | .B \-f | |
22 | option, it is read; otherwise, if a | |
23 | .I command | |
24 | is specified, it is executed with standard output and standard error | |
25 | redirected to | |
26 | .BR xcatch ; | |
27 | otherwise, | |
28 | .B xcatch | |
29 | reads from its own standard input. | |
bce8c6ee MW |
30 | .PP |
31 | It is better to write | |
32 | .IP | |
c1c9f4d2 | 33 | .B xcatch |
bce8c6ee MW |
34 | .I command args |
35 | .PP | |
36 | than | |
37 | .IP | |
38 | .I command args | |
39 | .B | xcatch | |
40 | .PP | |
41 | The former allows | |
42 | .B xcatch | |
43 | to collect the exit status of the | |
44 | .I command | |
45 | and (a) report it in its window, and (b) provide it (or a version of it) | |
46 | as its own exit status for the caller to check. It also enables | |
47 | .B xcatch | |
48 | to put the command line in its title bar. | |
e571b0f1 | 49 | .SS Options |
63351ac6 | 50 | .TP |
bce8c6ee | 51 | .BI "\-F, \-\-font " font |
c1c9f4d2 | 52 | Display output text in |
bce8c6ee MW |
53 | .I font |
54 | rather than GTK's default. | |
63351ac6 | 55 | .TP |
56 | .BI "\-f, \-\-file " file | |
57 | Read data from | |
58 | .I file | |
59 | instead of standard output. | |
63351ac6 | 60 | .SH BUGS |
61 | None currently known. | |
bce8c6ee MW |
62 | .SH SEE ALSO |
63 | .BR gtk-options (7). | |
f6795c17 MW |
64 | .SH AUTHOR |
65 | Mark Wooding (mdw@distorted.org.uk). |