Update README.md
[pp.git] / pp.1
blob987181c9dc479f557ee768593599082a673be872
1 .TH PP 1
2 .SH NAME
3 pp \- prepend the content of the first file in the second
4 .SH SYNOPSIS
5 .ad l
6 .nh
7 .B pp
8 [\fIsource\fR]
9 .IR target
10 .hy
11 .ad
12 .SH DESCRIPTION
13 The
14 .B pp
15 (prepend) utility takes the content of the file named by the
16 .IR source
17 operand and inserts or prepends it
18 above the first line of the file named by the
19 .IR target
20 operand. The file operands are processed in command-line order. If the
21 .IR source
22 file is a single dash (\(oq-\(cq) or absent,
23 .B pp
24 reads from the standard input.
25 .SH "EXIT STATUS"
26 The
27 .B pp
28 utility exits 0 on success, and 1 if an error occurs.
29 .SH EXAMPLES
30 .nf
31 .B pp header.txt spreadsheet.csv
32 .fi
33 .PP
34 Prepend contents of \fBheader.txt\fR to \fBspreadsheet.csv\fR.
35 .PP
36 .nf
37 .B pp - spreadsheet.csv
38 .fi
39 .PP
40 Prepend data it receives from standard input until it receives an EOF (\(oq^D\(cq) character to \fBspreadsheet.csv\fR.
41 .PP
42 .nf
43 .B pp spreadsheet.csv
44 .fi
45 .PP
46 Prepend data it receives from standard input until it receives an EOF (\(oq^D\(cq) character to \fBspreadsheet.csv\fR.
47 .SH AUTHOR
48 .MT alessio.chiapperini@\:nullbuffer.com
49 Alessio Chiapperini
50 .ME