1.\" $NetBSD: paste.1,v 1.9 2013/04/07 17:43:01 wiz Exp $ 2.\" 3.\" Copyright (c) 1989, 1990, 1993 4.\" The Regents of the University of California. 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. Neither the name of the University nor the names of its contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" from: @(#)paste.1 8.1 (Berkeley) 6/6/93 35.\" 36.Dd June 6, 1993 37.Dt PASTE 1 38.Os 39.Sh NAME 40.Nm paste 41.Nd merge corresponding or subsequent lines of files 42.Sh SYNOPSIS 43.Nm 44.Op Fl s 45.Op Fl d Ar list 46.Ar file ... 47.Sh DESCRIPTION 48The 49.Nm 50utility concatenates the corresponding lines of the given input files, 51replacing all but the last file's newline characters with a single tab 52character, and writes the resulting lines to standard output. 53If end-of-file is reached on an input file while other input files 54still contain data, the file is treated as if it were an endless source 55of empty lines. 56.Pp 57The options are as follows: 58.Bl -tag -width Fl 59.It Fl d Ar list 60Use one or more of the provided characters to replace the newline 61characters instead of the default tab. 62The characters in 63.Ar list 64are used circularly, i.e., when 65.Ar list 66is exhausted the first character from 67.Ar list 68is reused. 69This continues until a line from the last input file (in default operation) 70or the last line in each file (using the -s option) is displayed, at which 71time 72.Nm 73begins selecting characters from the beginning of 74.Ar list 75again. 76.Pp 77The following special characters can also be used in list: 78.Pp 79.Bl -tag -width flag -compact 80.It Li \en 81newline character 82.It Li \et 83tab character 84.It Li \e\e 85backslash character 86.It Li \e0 87Empty string (not a null character). 88.El 89.Pp 90Any other character preceded by a backslash is equivalent to the 91character itself. 92.It Fl s 93Concatenate all of the lines of each separate input file in command line 94order. 95The newline character of every line except the last line in each input 96file is replaced with the tab character, unless otherwise specified by 97the -d option. 98.El 99.Pp 100If 101.Ql Fl 102is specified for one or more of the input files, the standard 103input is used; standard input is read one line at a time, circularly, 104for each instance of 105.Ql Fl . 106.Sh EXIT STATUS 107.Ex -std 108.Sh SEE ALSO 109.Xr cut 1 , 110.Xr join 1 111.Sh STANDARDS 112The 113.Nm 114utility is expected to be 115.St -p1003.2 116compatible. 117