Annotation of src/usr.bin/paste/paste.1, Revision 1.1
1.1 ! deraadt 1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
! 2: .\" All rights reserved.
! 3: .\"
! 4: .\" This code is derived from software contributed to Berkeley by
! 5: .\" Adam S. Moskowitz and the Institute of Electrical and Electronics
! 6: .\" Engineers, Inc.
! 7: .\"
! 8: .\" Redistribution and use in source and binary forms, with or without
! 9: .\" modification, are permitted provided that the following conditions
! 10: .\" are met:
! 11: .\" 1. Redistributions of source code must retain the above copyright
! 12: .\" notice, this list of conditions and the following disclaimer.
! 13: .\" 2. Redistributions in binary form must reproduce the above copyright
! 14: .\" notice, this list of conditions and the following disclaimer in the
! 15: .\" documentation and/or other materials provided with the distribution.
! 16: .\" 3. All advertising materials mentioning features or use of this software
! 17: .\" must display the following acknowledgement:
! 18: .\" This product includes software developed by the University of
! 19: .\" California, Berkeley and its contributors.
! 20: .\" 4. Neither the name of the University nor the names of its contributors
! 21: .\" may be used to endorse or promote products derived from this software
! 22: .\" without specific prior written permission.
! 23: .\"
! 24: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
! 25: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 26: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 27: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 28: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 29: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 30: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 31: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 32: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 33: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 34: .\" SUCH DAMAGE.
! 35: .\"
! 36: .\" from: @(#)paste.1 5.6 (Berkeley) 7/27/91
! 37: .\" $Id: paste.1,v 1.2 1993/08/01 07:29:57 mycroft Exp $
! 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
! 49: .Ar file ...
! 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
! 62: .It Fl d Ar list
! 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)
! 73: or the last line in each file (using the -s option) is displayed, at which
! 74: time
! 75: .Nm paste
! 76: begins selecting characters from the beginning of
! 77: .Ar list
! 78: again.
! 79: .Pp
! 80: The following special characters can also be used in list:
! 81: .Pp
! 82: .Bl -tag -width flag -compact
! 83: .It Li \en
! 84: newline character
! 85: .It Li \et
! 86: tab character
! 87: .It Li \e\e
! 88: backslash character
! 89: .It Li \e0
! 90: Empty string (not a null character).
! 91: .El
! 92: .Pp
! 93: Any other character preceded by a backslash is equivalent to the
! 94: character itself.
! 95: .It Fl s
! 96: Concatenate all of the lines of each separate input file in command line
! 97: order.
! 98: The newline character of every line except the last line in each input
! 99: file is replaced with the tab character, unless otherwise specified by
! 100: the -d option.
! 101: .El
! 102: .Pp
! 103: If
! 104: .Ql Fl
! 105: is specified for one or more of the input files, the standard
! 106: input is used; standard input is read one line at a time, circularly,
! 107: for each instance of
! 108: .Ql Fl .
! 109: .Pp
! 110: The
! 111: .Nm paste
! 112: utility exits 0 on success, and >0 if an error occurs.
! 113: .Sh SEE ALSO
! 114: .Xr cut 1
! 115: .Sh STANDARDS
! 116: The
! 117: .Nm paste
! 118: utility is expected to be
! 119: .St -p1003.2
! 120: compatible.