man/man1/paste.1

   1 .TH PASTE 1
   2 .SH NAME
   3 paste \- paste multiple files together
   4 .SH SYNOPSIS
   5 \fBpaste\fR [\fB\-s\fR]\fR [\fB\-d\fI list\fR] \fIfile...\fR
   6 .br
   7 .de FL
   8 .TP
   9 \\fB\\$1\\fR
  10 \\$2
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  17 .SH OPTIONS
  18 .TP 5
  19 .B \-d
  20 # Set delimiter used to separate columns to \fIlist\fR.
  21 .TP 5
  22 .B \-s
  23 # Print files sequentially, file \fIk\fR on line \fIk\fR.
  24 .SH EXAMPLES
  25 .TP 20
  26 .B paste file1 file2
  27 # Print \fIfile1\fR in col 1, \fIfile2\fR in col 2
  28 .TP 20
  29 .B paste \-s f1 f2
  30 # Print \fIf1\fR on line 1 and \fIf2\fR on line 2
  31 .TP 20
  32 .B paste -d : file1 file2
  33 # Print the lines separated by a colon
  34 .SH DESCRIPTION
  35 .PP
  36 \fIPaste\fR concatenates corresponding lines of the given input files
  37 and writes them to standard output. The lines of the different files
  38 are separated by the delimiters given with the option \-s\fR. If
  39 no list is given, a tab is substituted for every linefeed, except the last one.
  40 If end-of-file is hit on an input file, subsequent lines are empty.
  41 Suppose a set of \fIk\fR files each has one word per line.
  42 Then the \fIpaste\fR output will have \fIk\fR columns,
  43 with the contents of file \fIj\fR in column \fIj\fR.
  44 If the \fB\-s\fR flag is given, then the first
  45 file is on line 1, the second file on line 2, etc.
  46 In effect, \fB\-s\fR turns the output sideways.
  47 .PP
  48 If a list of delimiters is given, they are used in turn.  The C escape
  49 sequences \\n, \\t, \\\\, and \\0 are used for linefeed, tab, backslash, and
  50 the null string, respectively.