mdw@git.distorted.org.uk Git - xtoys/blob - xcatch.1

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