home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / rcs / merge.man < prev    next >
Text File  |  1992-02-19  |  2KB  |  48 lines
  1. NAME
  2.      merge - three-way file merge
  3.  
  4. SYNOPSIS
  5.      merge [ -L label1 [ -L label3 ] ] [ -p ] [ -q ] file1 file2
  6.      file3
  7.  
  8. DESCRIPTION
  9.      merge incorporates all changes that lead from file2 to file3
  10.      into file1.  The result goes to standard output if -p is
  11.      present, into file1 otherwise.  merge is useful for
  12.      combining separate changes to an original.  Suppose file2 is
  13.      the original, and both file1 and file3 are modifications of
  14.      file2.  Then merge combines both changes.
  15.  
  16.      An overlap occurs if both file1 and file3 have changes in a
  17.      common segment of lines.  On a few older hosts where diff3
  18.      does not support the -E option, merge does not detect
  19.      overlaps, and merely supplies the changed lines from file3.
  20.      On most hosts, if overlaps occur, merge outputs a message
  21.      (unless the -q option is given), and includes both
  22.      alternatives in the result.  The alternatives are delimited
  23.      as follows:
  24.  
  25.           <<<<<<< file1
  26.           lines in file1
  27.           =======
  28.           lines in file3
  29.           >>>>>>> file3
  30.  
  31.      If there are overlaps, the user should edit the result and
  32.      delete one of the alternatives.  If the -L label1 and
  33.      -L label3 options are given, the labels are output in place
  34.      of the names file1 and file3 in overlap reports.
  35.  
  36. DIAGNOSTICS
  37.      Exit status is 0 for no overlaps, 1 for some overlaps, 2 for
  38.      trouble.
  39.  
  40. IDENTIFICATION
  41.      Author: Walter F. Tichy.
  42.      Revision Number: 5.4; Release Date: 1992/02/17.
  43.      Copyright 1982, 1988, 1989 by Walter F. Tichy.
  44.      Copyright 1990, 1991 by Paul Eggert.
  45.  
  46. SEE ALSO
  47.      diff3(1), diff(1), rcsmerge(1), co(1).
  48.