buf, buf.1: Allow the temporary file's extension to be set.

[misc] / buf.1

diff --git a/buf.1 b/buf.1
index 5dc47474fb947665f465dd452ed960e9351b2c1a..65b8a61f6eba9441d30a2b3ccee5b3d70167df12 100644 (file)
--- a/buf.1
+++ b/buf.1
@@ -15,6 +15,8 @@
 buf \- buffer stdin to a file
 .SH SYNOPSIS
 .B buf
+.RB [ \-e
+.IR ext ]
 .I command
 .RI [ arguments ...]
 .SH DESCRIPTION
@@ -26,11 +28,23 @@ program writes standard input to a temporary file.  It then runs
 .VE
 and exits with whatever exit status that exited with.
 .PP
+Command line options:
+.TP
+.B "\-h"
+Show very brief help.
+.TP
+.BI "\-e " ext
+Arrange that the temporary file has the suffix
+.IR ext .
+No
+.RB ` . '
+is included unless you provide one yourself.
+.PP
 This is particularly useful for programs which want to seek their
 standard input, for example PostScript viewers.  A typical invocation
 might be something like
 .VS
-man \-Tps buf | buf gv
+man \-Tps buf | buf \-e.ps gv
 .VE
 .SH BUGS
 Doesn't exit correctly if subprogram was killed by a signal.