NAME

       join  -  For each pair of input lines with identical join fields, write a line to standard
       output. The default join field is the first, delimited by blanks.

       When `FILE1` or `FILE2` (not both) is `-`, read standard input.

SYNOPSIS

       join [-a ] [-v ] [-e ] [-i|--ignore-case] [-j ] [-o ] [-t ] [-1 ]  [-2  ]  [--check-order]
       [--nocheck-order]  [--header]  [-z|--zero-terminated]  [-h|--help]  [-V|--version] <FILE1>
       <FILE2>

DESCRIPTION

       For each pair of input lines with identical join fields, write a line to standard  output.
       The default join field is the first, delimited by blanks.

       When `FILE1` or `FILE2` (not both) is `-`, read standard input.

OPTIONS

       -a=FILENUM
              also  print  unpairable  lines  from  file  FILENUM,  where  FILENUM  is  1  or  2,
              corresponding to FILE1 or FILE2

              [possible values: 1, 2]

       -v=FILENUM
              like -a FILENUM, but suppress joined output lines

              [possible values: 1, 2]

       -e=EMPTY
              replace missing input fields with EMPTY

       -i, --ignore-case
              ignore differences in case when comparing fields

       -j=FIELD
              equivalent to '-1 FIELD -2 FIELD'

       -o=FORMAT
              obey FORMAT while constructing output line

       -t=CHAR
              use CHAR as input and output field separator

       -1=FIELD
              join on this FIELD of file 1

       -2=FIELD
              join on this FIELD of file 2

       --check-order
              check that the input is correctly sorted, even if all input lines are pairable

       --nocheck-order
              do not check that the input is correctly sorted

       --header
              treat the first line in each file as field headers, print them  without  trying  to
              pair them

       -z, --zero-terminated
              line delimiter is NUL, not newline

       -h, --help
              Print help

       -V, --version
              Print version

VERSION

       v0.0.20

                                           join 0.0.20                                    join(1)