MAN page from RedHat Other textutils-1.22-1.1.i386.rpm
JOIN
Section: User Commands (1)
Updated: GNU Text Utilities
Index NAME
join - join lines of two files on a common field
SYNOPSIS
join[-a 1|2] [-v 1|2] [-e empty-string] [-o field-list...] [-t char][-j[1|2] field] [-1 field] [-2 field] file1 file2
join{--help,--version}
DESCRIPTION
This documentation is no longer being maintained and may be inaccurateor incomplete. The Texinfo documentation is now the authoritative source.
This manual pagedocuments the GNU version ofjoin.joinprints to the standard output a line for each pair of input lines, oneeach fromfile1andfile2,that have identical join fields. Either filename (but not both) canbe `-', meaning the standard input.file1andfile2should be already sorted in increasing order (not numerically) on thejoin fields; unless the-toption is given, they should be sorted ignoring blanks at the start ofthe line, assortdoes when given the-boption.
The defaults are: the join field is the first field in each line;fields in the input are separated by one or more blanks, with leadingblanks on the line ignored; fields in the output are separated by aspace; each output line consists of the join field, the remainingfields fromfile1,then the remaining fields fromfile2.
OPTIONS
- -a file-number
- Print a line for each unpairable line in filefile-number(either 1 or 2), in addition to the normal output.
- -e string
- Replace empty output fields (those that are missing in the input) withstring.
- -1, -j1 field
- Join on fieldfield(a positive integer) of file 1.
- -2, -j2 field
- Join on fieldfield(a positive integer) of file 2.
- -j field
- Equivalent to-1 field -2 field.
- -o field-list...
- Construct each output line according to the format infield-list.Each element infield-listconsists of a file number (either 1 or 2), a period, and a fieldnumber (a positive integer). The elements in the list are separatedby commas or blanks. Multiplefield-listarguments can be given after a single-ooption; the values of all lists given with-oare concatenated together.
- -t char
- Use charactercharas the input and output field separator.
- -v file-number
- Print a line for each unpairable line in filefile-number(either 1 or 2), instead of the normal output.
In addition, when GNUjoinis invoked with exactly one argument, the following options are recognized:
- --help
- Print a usage message on standard output and exit successfully.
- --version
- Print version information on standard output then exit successfully.
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
This document was created byman2html,using the manual pages.
