mdw@git.distorted.org.uk Git - misc/blob - buf.1

   1 .de VS
   2 .sp 1
   3 .RS
   4 .nf
   5 .ft B
   6 ..
   7 .de VE
   8 .ft R
   9 .fi
  10 .RE
  11 .sp 1
  12 ..
  13 .TH buf 1 "5 February 2005" "Edgeware tools"
  14 .SH NAME
  15 buf \- buffer stdin to a file
  16 .SH SYNOPSIS
  17 .B buf
  18 .RB [ \-e
  19 .IR ext ]
  20 .I command
  21 .RI [ arguments ...]
  22 .SH DESCRIPTION
  23 The
  24 .B buf
  25 program writes standard input to a temporary file.  It then runs
  26 .VS
  27 .IR "command arguments " ... " stdinfile"
  28 .VE
  29 and exits with whatever exit status that exited with.
  30 .PP
  31 Command line options:
  32 .TP
  33 .B "\-h"
  34 Show very brief help.
  35 .TP
  36 .BI "\-e " ext
  37 Arrange that the temporary file has the suffix
  38 .IR ext .
  39 No
  40 .RB ` . '
  41 is included unless you provide one yourself.
  42 .PP
  43 This is particularly useful for programs which want to seek their
  44 standard input, for example PostScript viewers.  A typical invocation
  45 might be something like
  46 .VS
  47 man \-Tps buf | buf \-e.ps gv
  48 .VE
  49 .SH BUGS
  50 Doesn't exit correctly if subprogram was killed by a signal.
  51 .SH AUTHOR
  52 Mark Wooding <mdw@distorted.org.uk>