home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs567x.zip / doc / merge.man < prev    next >
Text File  |  1994-03-22  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. MERGE(1)                                                 MERGE(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        merge - three-way file merge
  9.  
  10. SSYYNNOOPPSSIISS
  11.        mmeerrggee [ _o_p_t_i_o_n_s ] _f_i_l_e_1 _f_i_l_e_2 _f_i_l_e_3
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        mmeerrggee  incorporates  all  changes  that lead from _f_i_l_e_2 to
  15.        _f_i_l_e_3 into _f_i_l_e_1.  The result ordinarily goes into  _f_i_l_e_1.
  16.        mmeerrggee is useful for combining separate changes to an orig-
  17.        inal.  Suppose _f_i_l_e_2 is the original, and both  _f_i_l_e_1  and
  18.        _f_i_l_e_3  are  modifications  of  _f_i_l_e_2.  Then mmeerrggee combines
  19.        both changes.
  20.  
  21.        A conflict occurs if both _f_i_l_e_1 and _f_i_l_e_3 have changes  in
  22.        a  common segment of lines.  If a conflict is found, mmeerrggee
  23.        normally outputs a warning and brackets the conflict  with
  24.        <<<<<<<<<<<<<<  and  >>>>>>>>>>>>>> lines.  A typical conflict will look
  25.        like this:
  26.  
  27.               <<<<<<<<<<<<<< _f_i_l_e _A
  28.               _l_i_n_e_s _i_n _f_i_l_e _A
  29.               ==============
  30.               _l_i_n_e_s _i_n _f_i_l_e _B
  31.               >>>>>>>>>>>>>> _f_i_l_e _B
  32.  
  33.        If there are conflicts, the user should  edit  the  result
  34.        and delete one of the alternatives.
  35.  
  36. OOPPTTIIOONNSS
  37.        --AA     Output conflicts using the --AA style of ddiiffff33(1), if
  38.               supported by ddiiffff33.  This merges all changes  lead-
  39.               ing  from _f_i_l_e_2 to _f_i_l_e_3 into _f_i_l_e_1, and is usually
  40.               the best choice for merging.  This  option  is  the
  41.               default if ddiiffff33 supports it.
  42.  
  43.        --EE, --ee These options specify conflict styles that generate
  44.               less  information  than  --AA.   See   ddiiffff33(1)   for
  45.               details.   If ddiiffff33 does not support --AA, then --EE is
  46.               the default if it is supported, and  --ee  is  other-
  47.               wise.   With  --ee,  mmeerrggee  does  not warn about con-
  48.               flicts.
  49.  
  50.        --LL _l_a_b_e_l
  51.               This option may be given up  to  three  times,  and
  52.               specifies  labels to be used in place of the corre-
  53.               sponding file names in conflict reports.  That  is,
  54.               mmeerrggee --LL xx --LL yy --LL zz aa bb cc  generates  output  that
  55.               looks like it came from files xx, yy and zz instead of
  56.               from files aa, bb and cc.
  57.  
  58.        --pp     Send  results  to  standard output instead of over-
  59.               writing _f_i_l_e_1.
  60.  
  61.  
  62.  
  63.  
  64. GNU                         1993/11/09                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MERGE(1)                                                 MERGE(1)
  71.  
  72.  
  73.        --qq     Quiet; do not warn about conflicts.   --VV  Print  's
  74.               version number.
  75.  
  76. DDIIAAGGNNOOSSTTIICCSS
  77.        Exit status is 0 for no conflicts, 1 for some conflicts, 2
  78.        for trouble.
  79.  
  80. IIDDEENNTTIIFFIICCAATTIIOONN
  81.        Author: Walter F. Tichy.
  82.        Manual Page Revision: 5.6; Release Date: 1993/11/09.
  83.        Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
  84.        Copyright (C) 1990, 1991, 1992, 1993 Paul Eggert.
  85.  
  86. SSEEEE AALLSSOO
  87.        diff3(1), diff(1), rcsmerge(1), co(1).
  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. GNU                         1993/11/09                          2
  131.  
  132.  
  133.