X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-merge-file.txt;h=234269ae59234de67ea2cce42edec83cebc400be;hb=d16a5dafdcec037631a5453ca7923992ce27a151;hp=303537357b2fb5d1a0d7fa291d51803ddb97749c;hpb=5e2f779cbf60997809130fde213736e1ea4f6f33;p=git.git diff --git a/Documentation/git-merge-file.txt b/Documentation/git-merge-file.txt index 303537357..234269ae5 100644 --- a/Documentation/git-merge-file.txt +++ b/Documentation/git-merge-file.txt @@ -10,20 +10,21 @@ SYNOPSIS -------- [verse] 'git merge-file' [-L [-L [-L ]]] - [-p|--stdout] [-q|--quiet] + [--ours|--theirs] [-p|--stdout] [-q|--quiet] + DESCRIPTION ----------- -'git-merge-file' incorporates all changes that lead from the `` +'git merge-file' incorporates all changes that lead from the `` to `` into ``. The result ordinarily goes into -``. 'git-merge-file' is useful for combining separate changes +``. 'git merge-file' is useful for combining separate changes to an original. Suppose `` is the original, and both `` and `` are modifications of ``, -then 'git-merge-file' combines both changes. +then 'git merge-file' combines both changes. A conflict occurs if both `` and `` have changes -in a common segment of lines. If a conflict is found, 'git-merge-file' +in a common segment of lines. If a conflict is found, 'git merge-file' normally outputs a warning and brackets the conflict with lines containing <<<<<<< and >>>>>>> markers. A typical conflict will look like this: @@ -34,12 +35,14 @@ normally outputs a warning and brackets the conflict with lines containing >>>>>>> B If there are conflicts, the user should edit the result and delete one of -the alternatives. +the alternatives. When `--ours` or `--theirs` option is in effect, however, +these conflicts are resolved favouring lines from `` or +lines from `` respectively. 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 +'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 linkgit:git[1]. @@ -62,6 +65,11 @@ OPTIONS -q:: Quiet; do not warn about conflicts. +--ours:: +--theirs:: + Instead of leaving conflicts in the file, resolve conflicts + favouring our (or their) side of the lines. + EXAMPLES --------