Documentation/git-merge-file.txt

   1 git-merge-file(1)
   2 =================
   3
   4 NAME
   5 ----
   6 git-merge-file - Run a three-way file merge
   7
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  12 'git merge-file' [-L <current-name> [-L <base-name> [-L <other-name>]]]
  13         [--ours|--theirs] [-p|--stdout] [-q|--quiet]
  14         <current-file> <base-file> <other-file>
  15
  16
  17 DESCRIPTION
  18 -----------
  19 'git-merge-file' incorporates all changes that lead from the `<base-file>`
  20 to `<other-file>` into `<current-file>`. The result ordinarily goes into
  21 `<current-file>`. 'git-merge-file' is useful for combining separate changes
  22 to an original. Suppose `<base-file>` is the original, and both
  23 `<current-file>` and `<other-file>` are modifications of `<base-file>`,
  24 then 'git-merge-file' combines both changes.
  25
  26 A conflict occurs if both `<current-file>` and `<other-file>` have changes
  27 in a common segment of lines. If a conflict is found, 'git-merge-file'
  28 normally outputs a warning and brackets the conflict with lines containing
  29 <<<<<<< and >>>>>>> markers. A typical conflict will look like this:
  30
  31         <<<<<<< A
  32         lines in file A
  33         =======
  34         lines in file B
  35         >>>>>>> B
  36
  37 If there are conflicts, the user should edit the result and delete one of
  38 the alternatives.  When `--ours` or `--theirs` option is in effect, however,
  39 these conflicts are resolved favouring lines from `<current-file>` or
  40 lines from `<other-file>` respectively.
  41
  42 The exit value of this program is negative on error, and the number of
  43 conflicts otherwise. If the merge was clean, the exit value is 0.
  44
  45 'git-merge-file' is designed to be a minimal clone of RCS 'merge'; that is, it
  46 implements all of RCS 'merge''s functionality which is needed by
  47 linkgit:git[1].
  48
  49
  50 OPTIONS
  51 -------
  52
  53 -L <label>::
  54         This option may be given up to three times, and
  55         specifies labels to be used in place of the
  56         corresponding file names in conflict reports. That is,
  57         `git merge-file -L x -L y -L z a b c` generates output that
  58         looks like it came from files x, y and z instead of
  59         from files a, b and c.
  60
  61 -p::
  62         Send results to standard output instead of overwriting
  63         `<current-file>`.
  64
  65 -q::
  66         Quiet; do not warn about conflicts.
  67
  68 --ours::
  69 --theirs::
  70         Instead of leaving conflicts in the file, resolve conflicts
  71         favouring our (or their) side of the lines.
  72
  73
  74 EXAMPLES
  75 --------
  76
  77 git merge-file README.my README README.upstream::
  78
  79         combines the changes of README.my and README.upstream since README,
  80         tries to merge them and writes the result into README.my.
  81
  82 git merge-file -L a -L b -L c tmp/a123 tmp/b234 tmp/c345::
  83
  84         merges tmp/a123 and tmp/c345 with the base tmp/b234, but uses labels
  85         `a` and `c` instead of `tmp/a123` and `tmp/c345`.
  86
  87
  88 Author
  89 ------
  90 Written by Johannes Schindelin <johannes.schindelin@gmx.de>
  91
  92
  93 Documentation
  94 --------------
  95 Documentation by Johannes Schindelin and the git-list <git@vger.kernel.org>,
  96 with parts copied from the original documentation of RCS 'merge'.
  97
  98 GIT
  99 ---
 100 Part of the linkgit:git[1] suite