home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs57pc1.zip / doc / merge.man < prev    next >
Text File  |  1996-02-13  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. MERGE(1)                                                 MERGE(1)
  5.  
  6.  
  7. NAME
  8.        merge - three-way file merge
  9.  
  10. SYNOPSIS
  11.        merge [ options ] file1 file2 file3
  12.  
  13. DESCRIPTION
  14.        merge  incorporates  all  changes  that lead from file2 to
  15.        file3 into file1.  The result ordinarily goes into  file1.
  16.        merge is useful for combining separate changes to an orig-
  17.        inal.  Suppose file2 is the original, and both  file1  and
  18.        file3  are  modifications  of  file2.  Then merge combines
  19.        both changes.
  20.  
  21.        A conflict occurs if both file1 and file3 have changes  in
  22.        a  common segment of lines.  If a conflict is found, merge
  23.        normally outputs a warning and brackets the conflict  with
  24.        <<<<<<<  and  >>>>>>> lines.  A typical conflict will look
  25.        like this:
  26.  
  27.               <<<<<<< file A
  28.               lines in file A
  29.               =======
  30.               lines in file B
  31.               >>>>>>> file B
  32.  
  33.        If there are conflicts, the user should  edit  the  result
  34.        and delete one of the alternatives.
  35.  
  36. OPTIONS
  37.        -A     Output conflicts using the -A style of diff3(1), if
  38.               supported by diff3.  This merges all changes  lead-
  39.               ing  from  file2 to file3 into file1, and generates
  40.               the most verbose output.
  41.  
  42.        -E, -e These options specify conflict styles that generate
  43.               less   information   than  -A.   See  diff3(1)  for
  44.               details.  The default is -E.  With -e,  merge  does
  45.               not warn about conflicts.
  46.  
  47.        -L label
  48.               This  option  may  be  given up to three times, and
  49.               specifies labels to be used in place of the  corre-
  50.               sponding  file names in conflict reports.  That is,
  51.               merge -L x -L y -L z a b c  generates  output  that
  52.               looks like it came from files x, y and z instead of
  53.               from files a, b and c.
  54.  
  55.        -p     Send results to standard output  instead  of  over-
  56.               writing file1.
  57.  
  58.        -q     Quiet;  do  not  warn about conflicts.  -V Print 's
  59.               version number.
  60.  
  61.  
  62.  
  63.  
  64. GNU                         1995/06/01                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MERGE(1)                                                 MERGE(1)
  71.  
  72.  
  73. DIAGNOSTICS
  74.        Exit status is 0 for no conflicts, 1 for some conflicts, 2
  75.        for trouble.
  76.  
  77. IDENTIFICATION
  78.        Author: Walter F. Tichy.
  79.        Manual Page Revision: 5.7; Release Date: 1995/06/01.
  80.        Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
  81.        Copyright  (C)  1990,  1991,  1992,  1993, 1994, 1995 Paul
  82.        Eggert.
  83.  
  84. SEE ALSO
  85.        diff3(1), diff(1), rcsmerge(1), co(1).
  86.  
  87. BUGS
  88.        It normally does not make sense to merge binary  files  as
  89.        if they were text, but merge tries to do it anyway.
  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                         1995/06/01                          2
  131.  
  132.  
  133.