1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
2 .TH JOIN "1" "March 2007" "GNU coreutils 6.9" "User Commands"
4 join \- join lines of two files on a common field
7 [\fIOPTION\fR]... \fIFILE1 FILE2\fR
9 .\" Add any additional description here
11 For each pair of input lines with identical join fields, write a line to
12 standard output. The default join field is the first, delimited
13 by whitespace. When FILE1 or FILE2 (not both) is \-, read standard input.
16 print unpairable lines coming from file FILENUM, where
17 FILENUM is 1 or 2, corresponding to FILE1 or FILE2
20 replace missing input fields with EMPTY
22 \fB\-i\fR, \fB\-\-ignore\-case\fR
23 ignore differences in case when comparing fields
26 equivalent to `\-1 FIELD \fB\-2\fR FIELD'
29 obey FORMAT while constructing output line
32 use CHAR as input and output field separator
35 like \fB\-a\fR FILENUM, but suppress joined output lines
38 join on this FIELD of file 1
41 join on this FIELD of file 2
44 display this help and exit
47 output version information and exit
49 Unless \fB\-t\fR CHAR is given, leading blanks separate fields and are ignored,
50 else fields are separated by CHAR. Any FIELD is a field number counted
51 from 1. FORMAT is one or more comma or blank separated specifications,
52 each being `FILENUM.FIELD' or `0'. Default FORMAT outputs the join field,
53 the remaining fields from FILE1, the remaining fields from FILE2, all
56 Important: FILE1 and FILE2 must be sorted on the join fields.
57 E.g., use `sort \fB\-k\fR 1b,1' if `join' has no options.
59 Written by Mike Haertel.
61 Report bugs to <bug\-coreutils@gnu.org>.
63 Copyright \(co 2007 Free Software Foundation, Inc.
65 This is free software. You may redistribute copies of it under the terms of
66 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
67 There is NO WARRANTY, to the extent permitted by law.
69 The full documentation for
71 is maintained as a Texinfo manual. If the
75 programs are properly installed at your site, the command
79 should give you access to the complete manual.