X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=blobdiff_plain;f=Documentation%2Fgit-merge-file.txt;h=f334d694e0160df91d197293e5b76cc0bfaac187;hb=455bda993cceb42921c9ff173da26651f1d66602;hp=303537357b2fb5d1a0d7fa291d51803ddb97749c;hpb=b7380fa7a9adb52860eef7e8885fb8bc179beae1;p=git.git diff --git a/Documentation/git-merge-file.txt b/Documentation/git-merge-file.txt index 303537357..f334d694e 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|--union] [-p|--stdout] [-q|--quiet] [--marker-size=] + 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,15 @@ 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`, `--theirs`, or `--union` option is in effect, +however, these conflicts are resolved favouring lines from ``, +lines from ``, or lines from both respectively. The length of the +conflict markers can be given with the `--marker-size` option. 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 +66,12 @@ OPTIONS -q:: Quiet; do not warn about conflicts. +--ours:: +--theirs:: +--union:: + Instead of leaving conflicts in the file, resolve conflicts + favouring our (or their or both) side of the lines. + EXAMPLES --------