Commit | Line | Data |
---|---|---|
3770fe80 | 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 | |
8b628e9f MW |
18 | .RB [ \-e |
19 | .IR ext ] | |
3770fe80 | 20 | .I command |
21 | .RI [ arguments ...] | |
22 | .SH DESCRIPTION | |
23 | The | |
24 | .B buf | |
841e5aca | 25 | program writes standard input to a temporary file. It then runs |
3770fe80 | 26 | .VS |
27 | .IR "command arguments " ... " stdinfile" | |
28 | .VE | |
29 | and exits with whatever exit status that exited with. | |
30 | .PP | |
8b628e9f MW |
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 | |
3770fe80 | 43 | This is particularly useful for programs which want to seek their |
eb16118c | 44 | standard input, for example PostScript viewers. A typical invocation |
3770fe80 | 45 | might be something like |
46 | .VS | |
8b628e9f | 47 | man \-Tps buf | buf \-e.ps gv |
3770fe80 | 48 | .VE |
49 | .SH BUGS | |
50 | Doesn't exit correctly if subprogram was killed by a signal. | |
51 | .SH AUTHOR | |
71d8432e | 52 | Mark Wooding <mdw@distorted.org.uk> |