New program: captures input and puts it in a window.

[xtoys] / xcatch.1

diff --git a/xcatch.1 b/xcatch.1
new file mode 100644 (file)
index 0000000..c9d91d8
--- /dev/null
+++ b/xcatch.1
@@ -0,0 +1,46 @@
+.TH xcatch 1 "15 December 1998" "Edgeware tools"
+.SH NAME
+xcatch \- catch input and trap it in a window
+.SH SYNOPSIS
+.B xcatch
+.RB [ \-f
+.IR file ]
+.RB [ \-F
+.IR font ]
+.RI [ command
+.RI [ args ]...]
+.SH DESCRIPTION
+The
+.B xcatch
+program watches an input file descriptor (usually a pipe) and displays
+data from it in a GTK window.  The window is displayed only when data is
+first read from the descriptor; if no data ever arrives, the window is
+not created.  If a file is specified using the
+.B \-f
+option, it is read; otherwise, if a
+.I command
+is specified, it is executed with standard output and standard error
+redirected to
+.BR xcatch ;
+otherwise,
+.B xcatch
+reads from its own standard input.
+.SS OPTIONS
+.TP
+.BI "\-\-display " display
+Create the window on the named
+.IR display .
+.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.