home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / join.1 < prev    next >
Encoding:
Text File  |  1994-07-26  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. JOIN(1L)          Misc. Reference Manual Pages           JOIN(1L)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      join - join lines of two files on a common field
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      jjjjooooiiiinnnn [-a 1|2] [-v 1|2] [-e empty-string] [-o  field-list...]
  13.      [-t char] [-j[1|2] field] [-1 field] [-2 field] file1 file2
  14.      jjjjooooiiiinnnn {--help,--version}
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      This manual page documents the GNU version  of  jjjjooooiiiinnnn.   jjjjooooiiiinnnn
  18.      prints  to the standard output a line for each pair of input
  19.      lines, one each from _f_i_l_e_1 and _f_i_l_e_2,  that  have  identical
  20.      join  fields.   Either  filename  (but not both) can be `-',
  21.      meaning the standard  input.   _f_i_l_e_1  and  _f_i_l_e_2  should  be
  22.      already  sorted in increasing order (not numerically) on the
  23.      join fields; unless the -_t option is given, they  should  be
  24.      sorted  ignoring  blanks  at  the start of the line, as ssssoooorrrrtttt
  25.      does when given the -_b option.
  26.  
  27.      The defaults are: the join field is the first field in  each
  28.      line;  fields  in  the  input  are  separated by one or more
  29.      blanks, with leading blanks on the line ignored;  fields  in
  30.      the  output  are separated by a space; each output line con-
  31.      sists of the join field, the remaining  fields  from  _f_i_l_e_1,
  32.      then the remaining fields from _f_i_l_e_2.
  33.  
  34.   OOOOPPPPTTTTIIIIOOOONNNNSSSS
  35.      -_a _f_i_l_e-_n_u_m_b_e_r
  36.           Print a line for each unpairable  line  in  file  _f_i_l_e-
  37.           _n_u_m_b_e_r  (either 1 or 2), in addition to the normal out-
  38.           put.
  39.  
  40.      -_e _s_t_r_i_n_g
  41.           Replace empty output fields (those that are missing  in
  42.           the input) with _s_t_r_i_n_g.
  43.  
  44.      -_1, -_j_1 _f_i_e_l_d
  45.           Join on field _f_i_e_l_d (a positive integer) of file 1.
  46.  
  47.      -_2, -_j_2 _f_i_e_l_d
  48.           Join on field _f_i_e_l_d (a positive integer) of file 2.
  49.  
  50.      -_j _f_i_e_l_d
  51.           Equivalent to -_1 _f_i_e_l_d -_2 _f_i_e_l_d.
  52.  
  53.      -_o _f_i_e_l_d-_l_i_s_t...
  54.           Construct each output line according to the  format  in
  55.           _f_i_e_l_d-_l_i_s_t.   Each  element in _f_i_e_l_d-_l_i_s_t consists of a
  56.           file number (either 1 or 2),  a  period,  and  a  field
  57.           number  (a positive integer).  The elements in the list
  58.           are separated by commas or blanks.  Multiple _f_i_e_l_d-_l_i_s_t
  59.           arguments  can  be  given after a single -_o option; the
  60.  
  61.  
  62.  
  63. FSF              Last change: GNU Text Utilities                1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOIN(1L)          Misc. Reference Manual Pages           JOIN(1L)
  71.  
  72.  
  73.  
  74.           values of all lists given with   - _o  are  concatenated
  75.           together.
  76.  
  77.      -_t _c_h_a_r
  78.           Use character  _c_h_a_r  as  the  input  and  output  field
  79.           separator.
  80.  
  81.      -_v _f_i_l_e-_n_u_m_b_e_r
  82.           Print a line for each unpairable  line  in  file  _f_i_l_e-
  83.           _n_u_m_b_e_r (either 1 or 2), instead of the normal output.
  84.  
  85.      In addition, when GNU jjjjooooiiiinnnn is invoked with exactly one argu-
  86.      ment, the following options are recognized:
  87.  
  88.      --_h_e_l_p
  89.           Print a usage message on standard output and exit  suc-
  90.           cessfully.
  91.  
  92.      --_v_e_r_s_i_o_n
  93.           Print version information on standard output then  exit
  94.           successfully.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. FSF              Last change: GNU Text Utilities                2
  130.  
  131.  
  132.  
  133.