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