GIT\-MERGE\-FILESection: Git Manual (1)
Index Return to Main Contents
NAMEgit-merge-file - Run a three-way file merge
git-merge-file [-L <current-name> [-L <base-name> [-L <other-name>]]] [-p|--stdout] [-q|--quiet] <current-file> <base-file> <other-file>
DESCRIPTIONgit-file-merge incorporates all changes that lead from the <base-file> to <other-file> into <current-file>. The result ordinarily goes into <current-file>. git-merge-file is useful for combining separate changes to an original. Suppose <base-file> is the original, and both <current-file> and <other-file> are modifications of <base-file>. Then git-merge-file combines both changes.
A conflict occurs if both <current-file> and <other-file> have changes in a common segment of lines. If a conflict is found, git-merge-file normally outputs a warning and brackets the conflict with <<<<<<< and >>>>>>> lines. A typical conflict will look like this:
<<<<<<< A lines in file A ======= lines in file B >>>>>>> B
The exit value of this program is negative on error, and the number of conflicts otherwise. If the merge was clean, the exit value is 0.
git-merge-file is designed to be a minimal clone of RCS merge, that is, it implements all of RCS merge's functionality which is needed by git(1).
- This option may be given up to three times, and specifies labels to be used in place of the corresponding file names in conflict reports. That is, git-merge-file -L x -L y -L z a b c generates output that looks like it came from files x, y and z instead of from files a, b and c.
- Send results to standard output instead of overwriting <current-file>.
- Quiet; do not warn about conflicts.
git merge-file README.my README README.upstream
- combines the changes of README.my and README.upstream since README, tries to merge them and writes the result into README.my.
git merge-file -L a -L b -L c tmp/a123 tmp/b234 tmp/c345
- merges tmp/a123 and tmp/c345 with the base tmp/b234, but uses labels a and c instead of tmp/a123 and tmp/c345.
AUTHORWritten by Johannes Schindelin <firstname.lastname@example.org>
DOCUMENTATIONDocumentation by Johannes Schindelin and the git-list <email@example.com>, with parts copied from the original documentation of RCS merge.
GITPart of the git(7) suite