


MERGE(1)                 USER COMMANDS                   MERGE(1)



NAME
     merge - three-way file merge

SYNOPSIS
     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
     _f_i_l_e_3

DESCRIPTION
     merge incorporates all changes that lead from _f_i_l_e_2 to _f_i_l_e_3
     into  _f_i_l_e_1.   The  result  goes to standard output if -p is
     present, into _f_i_l_e_1 otherwise.  merge is useful for  combin-
     ing  separate  changes to an original.  Suppose _f_i_l_e_2 is the
     original, and both _f_i_l_e_1  and  _f_i_l_e_3  are  modifications  of
     _f_i_l_e_2.  Then merge combines both changes.

     An overlap occurs if both _f_i_l_e_1 and _f_i_l_e_3 have changes in  a
     common  segment  of lines.  merge outputs a message if over-
     laps occurred, and includes both alternatives in the result.
     The alternatives are delimited as follows:

          <<<<<<< _f_i_l_e_1
          _l_i_n_e_s _i_n _f_i_l_e_1
          =======
          _l_i_n_e_s _i_n _f_i_l_e_3
          >>>>>>> _f_i_l_e_3

     If there are overlaps, the user should edit the  result  and
     delete  one  of  the  alternatives.   If  the  -L _l_a_b_e_l_1 and
     -L _l_a_b_e_l_3 options are given, the labels are output in  place
     of  the names _f_i_l_e_1 and _f_i_l_e_3 in overlap reports.  Any over-
     lap message is suppressed if the -q option is given.

DIAGNOSTICS
     Exit status is 0 for no overlaps, 1 for some overlaps, 2 for
     trouble.

IDENTIFICATION
     Author: Walter F. Tichy.
     Revision Number: 5.1; Release Date: 1990/08/29.
     Copyright 8c9 1982, 1988, 1989 by Walter F. Tichy.
     Copyright 8c9 1990 by Paul Eggert.

SEE ALSO
     diff3(1), diff(1), rcsmerge(1), co(1).











GNU                  Last change: 1990/08/29                    1



