New scripts.

[misc] / buf.1

diff --git a/buf.1 b/buf.1
new file mode 100644 (file)
index 0000000..0039a90
--- /dev/null
+++ b/buf.1
@@ -0,0 +1,38 @@
+.de VS
+.sp 1
+.RS
+.nf
+.ft B
+..
+.de VE
+.ft R
+.fi
+.RE
+.sp 1
+..
+.TH buf 1 "5 February 2005" "Edgeware tools"
+.SH NAME
+buf \- buffer stdin to a file
+.SH SYNOPSIS
+.B buf
+.I command
+.RI [ arguments ...]
+.SH DESCRIPTION
+The
+.B buf
+program writes standard input to a temporary file.  It then runs 
+.VS
+.IR "command arguments " ... " stdinfile"
+.VE
+and exits with whatever exit status that exited with.
+.PP
+This is particularly useful for programs which want to seek their
+standard input, for example PostScript viewers.  A typical invokation
+might be something like
+.VS
+man -Tps buf | buf gv
+.VE
+.SH BUGS
+Doesn't exit correctly if subprogram was killed by a signal.
+.SH AUTHOR
+Mark Wooding (mdw@nsict.org).