Annotation of src/usr.bin/paste/paste.1, Revision 1.4
1.4 ! aaron 1: .\" $OpenBSD: paste.1,v 1.3 1998/09/27 16:57:49 aaron Exp $
1.1 deraadt 2: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
3: .\" All rights reserved.
4: .\"
5: .\" This code is derived from software contributed to Berkeley by
6: .\" Adam S. Moskowitz and the Institute of Electrical and Electronics
7: .\" Engineers, Inc.
8: .\"
9: .\" Redistribution and use in source and binary forms, with or without
10: .\" modification, are permitted provided that the following conditions
11: .\" are met:
12: .\" 1. Redistributions of source code must retain the above copyright
13: .\" notice, this list of conditions and the following disclaimer.
14: .\" 2. Redistributions in binary form must reproduce the above copyright
15: .\" notice, this list of conditions and the following disclaimer in the
16: .\" documentation and/or other materials provided with the distribution.
17: .\" 3. All advertising materials mentioning features or use of this software
18: .\" must display the following acknowledgement:
19: .\" This product includes software developed by the University of
20: .\" California, Berkeley and its contributors.
21: .\" 4. Neither the name of the University nor the names of its contributors
22: .\" may be used to endorse or promote products derived from this software
23: .\" without specific prior written permission.
24: .\"
25: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35: .\" SUCH DAMAGE.
36: .\"
37: .\" from: @(#)paste.1 5.6 (Berkeley) 7/27/91
38: .\"
39: .Dd July 27, 1991
40: .Dt PASTE 1
41: .Os
42: .Sh NAME
43: .Nm paste
44: .Nd merge corresponding or subsequent lines of files
45: .Sh SYNOPSIS
46: .Nm paste
47: .Op Fl s
48: .Op Fl d Ar list
1.3 aaron 49: .Ar file Op Ar ...
1.1 deraadt 50: .Sh DESCRIPTION
51: The
52: .Nm paste
53: utility concatenates the corresponding lines of the given input files,
54: replacing all but the last file's newline characters with a single tab
55: character, and writes the resulting lines to standard output.
56: If end-of-file is reached on an input file while other input files
57: still contain data, the file is treated as if it were an endless source
58: of empty lines.
59: .Pp
60: The options are as follows:
61: .Bl -tag -width Fl
1.4 ! aaron 62: .It Fl d Ar list
1.1 deraadt 63: Use one or more of the provided characters to replace the newline
64: characters instead of the default tab.
65: The characters in
66: .Ar list
67: are used circularly, i.e., when
68: .Ar list
69: is exhausted the first character from
70: .Ar list
71: is reused.
72: This continues until a line from the last input file (in default operation)
1.3 aaron 73: or the last line in each file (using the
74: .Fl s
75: option) is displayed, at which
1.1 deraadt 76: time
77: .Nm paste
78: begins selecting characters from the beginning of
79: .Ar list
80: again.
81: .Pp
82: The following special characters can also be used in list:
83: .Pp
84: .Bl -tag -width flag -compact
85: .It Li \en
86: newline character
87: .It Li \et
88: tab character
89: .It Li \e\e
90: backslash character
91: .It Li \e0
1.3 aaron 92: empty string (not a null character)
1.1 deraadt 93: .El
94: .Pp
95: Any other character preceded by a backslash is equivalent to the
96: character itself.
97: .It Fl s
98: Concatenate all of the lines of each separate input file in command line
99: order.
100: The newline character of every line except the last line in each input
101: file is replaced with the tab character, unless otherwise specified by
1.3 aaron 102: the
103: .Fl d
104: option.
1.1 deraadt 105: .El
106: .Pp
107: If
108: .Ql Fl
109: is specified for one or more of the input files, the standard
110: input is used; standard input is read one line at a time, circularly,
111: for each instance of
112: .Ql Fl .
113: .Pp
114: The
115: .Nm paste
1.3 aaron 116: utility exits 0 on success or >0 if an error occurred.
1.1 deraadt 117: .Sh SEE ALSO
118: .Xr cut 1
119: .Sh STANDARDS
120: The
121: .Nm paste
122: utility is expected to be
123: .St -p1003.2
124: compatible.