home *** CD-ROM | disk | FTP | other *** search
/ Dream 51 / Amiga_Dream_51.iso / Atari / Desktops / text113b.zoo / textutils-1.13 / man / join.1 < prev    next >
Text File  |  1996-01-21  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. JOIN(1)                                                   JOIN(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        join - join lines of two files on a common field
  9.  
  10. SSYYNNOOPPSSIISS
  11.        jjooiinn  [-a  1|2]  [-v  1|2]  [-e  empty-string]  [-o field-
  12.        list...] [-t char] [-j[1|2] field] [-1 field]  [-2  field]
  13.        file1 file2
  14.        jjooiinn {--help,--version}
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        This  manual page documents the GNU version of jjooiinn.  jjooiinn
  18.        prints to the standard output a  line  for  each  pair  of
  19.        input  lines,  one  each  from  _f_i_l_e_1 and _f_i_l_e_2, that have
  20.        identical join fields.  Either filename (but not both) can
  21.        be  `-',  meaning  the  standard  input.   _f_i_l_e_1 and _f_i_l_e_2
  22.        should be already sorted in increasing order (not  numeri-
  23.        cally)  on the join fields; unless the _-_t option is given,
  24.        they should be sorted ignoring blanks at the start of  the
  25.        line, as ssoorrtt does when given the _-_b option.
  26.  
  27.        The  defaults  are:  the  join field is the first field in
  28.        each line; fields in the input are  separated  by  one  or
  29.        more  blanks,  with  leading  blanks  on the line ignored;
  30.        fields in the output are separated by a space; each output
  31.        line consists of the join field, the remaining fields from
  32.        _f_i_l_e_1, then the remaining fields from _f_i_l_e_2.
  33.  
  34.    OOPPTTIIOONNSS
  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
  38.               output.
  39.  
  40.        _-_e _s_t_r_i_n_g
  41.               Replace empty output fields (those that are missing
  42.               in 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
  55.               in _f_i_e_l_d_-_l_i_s_t.  Each element in _f_i_e_l_d_-_l_i_s_t consists
  56.               of  a  file number (either 1 or 2), a period, and a
  57.               field number (a positive integer).  The elements in
  58.               the list are separated by commas or blanks.  Multi-
  59.               ple _f_i_e_l_d_-_l_i_s_t arguments can be given after a  sin-
  60.               gle  _-_o  option; the values of all lists given with
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOIN(1)                                                   JOIN(1)
  71.  
  72.  
  73.               _-_o are concatenated together.
  74.  
  75.        _-_t _c_h_a_r
  76.               Use character _c_h_a_r as the input  and  output  field
  77.               separator.
  78.  
  79.        _-_v _f_i_l_e_-_n_u_m_b_e_r
  80.               Print a line for each unpairable line in file _f_i_l_e_-
  81.               _n_u_m_b_e_r (either 1 or 2), instead of the normal  out-
  82.               put.
  83.  
  84.        In  addition,  when  GNU  jjooiinn is invoked with exactly one
  85.        argument, the following options are recognized:
  86.  
  87.        _-_-_h_e_l_p Print a usage message on standard output  and  exit
  88.               successfully.
  89.  
  90.        _-_-_v_e_r_s_i_o_n
  91.               Print  version  information on standard output then
  92.               exit successfully.
  93.  
  94.  
  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.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.