home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / textutils-1.9-bin.lha / man / cat1 / join.0 < prev    next >
Text File  |  1993-12-07  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. JOIN(1L)                                                 JOIN(1L)
  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.        [--help] [--version] file1 file2
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        This  manual page documents the GNU version of jjooiinn.  jjooiinn
  17.        prints to the standard output a  line  for  each  pair  of
  18.        input  lines,  one  each  from  _f_i_l_e_1 and _f_i_l_e_2, that have
  19.        identical join fields.  Either filename (but not both) can
  20.        be  `-',  meaning  the  standard  input.   _f_i_l_e_1 and _f_i_l_e_2
  21.        should be already sorted in increasing order (not  numeri-
  22.        cally)  on the join fields; unless the _-_t option is given,
  23.        they should be sorted ignoring blanks at the start of  the
  24.        line, as ssoorrtt does when given the _-_b option.
  25.  
  26.        The  defaults  are:  the  join field is the first field in
  27.        each line; fields in the input are  separated  by  one  or
  28.        more  blanks,  with  leading  blanks  on the line ignored;
  29.        fields in the output are separated by a space; each output
  30.        line consists of the join field, the remaining fields from
  31.        _f_i_l_e_1, then the remaining fields from _f_i_l_e_2.
  32.  
  33.    OOPPTTIIOONNSS
  34.        _-_a _f_i_l_e_-_n_u_m_b_e_r
  35.               Print a line for each unpairable line in file _f_i_l_e_-
  36.               _n_u_m_b_e_r  (either  1 or 2), in addition to the normal
  37.               output.
  38.  
  39.        _-_e _s_t_r_i_n_g
  40.               Replace empty output fields (those that are missing
  41.               in the input) with _s_t_r_i_n_g.
  42.  
  43.        _-_1_, _-_j_1 _f_i_e_l_d
  44.               Join on field _f_i_e_l_d (a positive integer) of file 1.
  45.  
  46.        _-_2_, _-_j_2 _f_i_e_l_d
  47.               Join on field _f_i_e_l_d (a positive integer) of file 2.
  48.  
  49.        _-_j _f_i_e_l_d
  50.               Equivalent to _-_1 _f_i_e_l_d _-_2 _f_i_e_l_d.
  51.  
  52.        _-_o _f_i_e_l_d_-_l_i_s_t_._._.
  53.               Construct  each output line according to the format
  54.               in _f_i_e_l_d_-_l_i_s_t.  Each element in _f_i_e_l_d_-_l_i_s_t consists
  55.               of  a  file number (either 1 or 2), a period, and a
  56.               field number (a positive integer).  The elements in
  57.               the list are separated by commas or blanks.  Multi-
  58.               ple _f_i_e_l_d_-_l_i_s_t arguments can be given after a  sin-
  59.               gle  _-_o  option; the values of all lists given with
  60.               _-_o are concatenated together.
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOIN(1L)                                                 JOIN(1L)
  71.  
  72.  
  73.        _-_t _c_h_a_r
  74.               Use character _c_h_a_r as the input  and  output  field
  75.               separator.
  76.  
  77.        _-_v _f_i_l_e_-_n_u_m_b_e_r
  78.               Print a line for each unpairable line in file _f_i_l_e_-
  79.               _n_u_m_b_e_r (either 1 or 2), instead of the normal  out-
  80.               put.
  81.  
  82.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  83.               tus.
  84.  
  85.        _-_-_v_e_r_s_i_o_n
  86.               Print version information on  standard  error  then
  87.               exit.
  88.  
  89.  
  90.  
  91.  
  92.  
  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.