home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / dev / RevisionControl / HWGRCS / hwgrcs / man / merge.man < prev    next >
Text File  |  1993-01-19  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. MERGE(1)                 USER COMMANDS                   MERGE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      merge - three-way file merge
  10.  
  11. SYNOPSIS
  12.      merge [ -L _l_a_b_e_l_1 [ -L _l_a_b_e_l_3 ] ] [ -p ] [ -q ] _f_i_l_e_1  _f_i_l_e_2
  13.      _f_i_l_e_3
  14.  
  15. DESCRIPTION
  16.      merge incorporates all changes that lead from _f_i_l_e_2 to _f_i_l_e_3
  17.      into  _f_i_l_e_1.   The  result  goes to standard output if -p is
  18.      present, into _f_i_l_e_1 otherwise.  merge is useful for  combin-
  19.      ing  separate  changes to an original.  Suppose _f_i_l_e_2 is the
  20.      original, and both _f_i_l_e_1  and  _f_i_l_e_3  are  modifications  of
  21.      _f_i_l_e_2.  Then merge combines both changes.
  22.  
  23.      An overlap occurs if both _f_i_l_e_1 and _f_i_l_e_3 have changes in  a
  24.      common  segment  of lines.  On a few older hosts where diff3
  25.      does not support the -E option, merge does not detect  over-
  26.      laps,  and  merely supplies the changed lines from _f_i_l_e_3. On
  27.      most hosts, if  overlaps  occur,  merge  outputs  a  message
  28.      (unless  the -q option is given), and includes both alterna-
  29.      tives in the result.  The alternatives are delimited as fol-
  30.      lows:
  31.  
  32.           <<<<<<< _f_i_l_e_1
  33.           _l_i_n_e_s _i_n _f_i_l_e_1
  34.           =======
  35.           _l_i_n_e_s _i_n _f_i_l_e_3
  36.           >>>>>>> _f_i_l_e_3
  37.  
  38.      If there are overlaps, the user should edit the  result  and
  39.      delete  one  of  the  alternatives.   If  the  -L _l_a_b_e_l_1 and
  40.      -L _l_a_b_e_l_3 options are given, the labels are output in  place
  41.      of the names _f_i_l_e_1 and _f_i_l_e_3 in overlap reports.
  42.  
  43. DIAGNOSTICS
  44.      Exit status is 0 for no overlaps, 1 for some overlaps, 2 for
  45.      trouble.
  46.  
  47. IDENTIFICATION
  48.      Author: Walter F. Tichy.
  49.      Revision Number: 5.3; Release Date: 1991/02/28.
  50.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  51.      Copyright c 1990, 1991 by Paul Eggert.
  52.  
  53. SEE ALSO
  54.      diff3(1), diff(1), rcsmerge(1), co(1).
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. GNU                  Last change: 1991/02/28                    1
  64.  
  65.  
  66.  
  67.