]>
Commit | Line | Data |
---|---|---|
ea24a76a NTND |
1 | mergetool.<tool>.path:: |
2 | Override the path for the given tool. This is useful in case | |
3 | your tool is not in the PATH. | |
4 | ||
5 | mergetool.<tool>.cmd:: | |
6 | Specify the command to invoke the specified merge tool. The | |
7 | specified command is evaluated in shell with the following | |
8 | variables available: 'BASE' is the name of a temporary file | |
9 | containing the common base of the files to be merged, if available; | |
10 | 'LOCAL' is the name of a temporary file containing the contents of | |
11 | the file on the current branch; 'REMOTE' is the name of a temporary | |
12 | file containing the contents of the file from the branch being | |
13 | merged; 'MERGED' contains the name of the file to which the merge | |
14 | tool should write the results of a successful merge. | |
15 | ||
9d9cf230 SH |
16 | mergetool.<tool>.hideResolved:: |
17 | Allows the user to override the global `mergetool.hideResolved` value | |
18 | for a specific tool. See `mergetool.hideResolved` for the full | |
19 | description. | |
20 | ||
ea24a76a NTND |
21 | mergetool.<tool>.trustExitCode:: |
22 | For a custom merge command, specify whether the exit code of | |
23 | the merge command can be used to determine whether the merge was | |
24 | successful. If this is not set to true then the merge target file | |
25 | timestamp is checked and the merge assumed to have been successful | |
26 | if the file has been updated, otherwise the user is prompted to | |
27 | indicate the success of the merge. | |
28 | ||
29 | mergetool.meld.hasOutput:: | |
30 | Older versions of `meld` do not support the `--output` option. | |
31 | Git will attempt to detect whether `meld` supports `--output` | |
32 | by inspecting the output of `meld --help`. Configuring | |
33 | `mergetool.meld.hasOutput` will make Git skip these checks and | |
34 | use the configured value instead. Setting `mergetool.meld.hasOutput` | |
35 | to `true` tells Git to unconditionally use the `--output` option, | |
36 | and `false` avoids using `--output`. | |
37 | ||
dbd8c09b LS |
38 | mergetool.meld.useAutoMerge:: |
39 | When the `--auto-merge` is given, meld will merge all non-conflicting | |
40 | parts automatically, highlight the conflicting parts and wait for | |
41 | user decision. Setting `mergetool.meld.useAutoMerge` to `true` tells | |
42 | Git to unconditionally use the `--auto-merge` option with `meld`. | |
43 | Setting this value to `auto` makes git detect whether `--auto-merge` | |
44 | is supported and will only use `--auto-merge` when available. A | |
45 | value of `false` avoids using `--auto-merge` altogether, and is the | |
46 | default value. | |
47 | ||
98ea309b SH |
48 | mergetool.hideResolved:: |
49 | During a merge Git will automatically resolve as many conflicts as | |
50 | possible and write the 'MERGED' file containing conflict markers around | |
51 | any conflicts that it cannot resolve; 'LOCAL' and 'REMOTE' normally | |
52 | represent the versions of the file from before Git's conflict | |
53 | resolution. This flag causes 'LOCAL' and 'REMOTE' to be overwriten so | |
54 | that only the unresolved conflicts are presented to the merge tool. Can | |
55 | be configured per-tool via the `mergetool.<tool>.hideResolved` | |
b2a51c1b | 56 | configuration variable. Defaults to `false`. |
98ea309b | 57 | |
ea24a76a NTND |
58 | mergetool.keepBackup:: |
59 | After performing a merge, the original file with conflict markers | |
60 | can be saved as a file with a `.orig` extension. If this variable | |
61 | is set to `false` then this file is not preserved. Defaults to | |
62 | `true` (i.e. keep the backup files). | |
63 | ||
64 | mergetool.keepTemporaries:: | |
65 | When invoking a custom merge tool, Git uses a set of temporary | |
66 | files to pass to the tool. If the tool returns an error and this | |
67 | variable is set to `true`, then these temporary files will be | |
68 | preserved, otherwise they will be removed after the tool has | |
69 | exited. Defaults to `false`. | |
70 | ||
71 | mergetool.writeToTemp:: | |
72 | Git writes temporary 'BASE', 'LOCAL', and 'REMOTE' versions of | |
73 | conflicting files in the worktree by default. Git will attempt | |
74 | to use a temporary directory for these files when set `true`. | |
75 | Defaults to `false`. | |
76 | ||
77 | mergetool.prompt:: | |
78 | Prompt before each invocation of the merge resolution program. |