How can I make WinMerge my git mergetool?
You are talking about merge tool, yet you (and some other people with answers) are configuring it as a diff tool.
To configure a merge tool, you'd need to use merge.tool
and mergetool
configurations instead of diff.tool
and difftool
, like this:
git config --global merge.tool winmerge
git config --replace --global mergetool.winmerge.cmd "\"C:\Program Files (x86)\WinMerge\WinMergeU.exe\" -e -u -dl \"Base\" -dr \"Mine\" \"$LOCAL\" \"$REMOTE\" \"$MERGED\""
git config --global mergetool.prompt false
And then you can use
git mergetool
which will open you the two files to edit.
Kudos for @dvdvck mentioning in the comments that in command line parameters you can specify a third file for the result file for winmerge (outputpath parameter).
For completeness, I'll mention that there is also this gist aimed at full configuration of winmerge for both as diff and merge tool.
If you decide to use SourceTree (or for any Google searchers with SourceTree), you can use WinMerge for the Merge Tool by setting the Merge Tool to custom, pointing Diff Command to WinMergeU.exe, typically:
C:\Program Files (x86)\WinMerge\WinMergeU.exe
In Arguments use:
-e -u -dl "Mine" -wr -dr "Theirs" $LOCAL $REMOTE $MERGED
That will cause the left side (labeled "Mine") to be editable and it will be the output file when you save in WinMerge. The right side (labeled "Theirs") will be read only (that's the -wr argument), this is needed because WinMerge outputs all saved files to the $MERGED file, so if both sides were edited, it would output the left side then overwrite that with the right side; best to avoid that kind of confusion.
If you leave the backup file option turned on, WinMerge will generate a .bak file. The contents of this file will either be the original left side file, or the second to last output file if you saved multiple times. You can either turn this off, or add *.bak to your .gitignore file.
Git itself will create a *.orig conflict file AFTER the conflict is resolved, just in case you botched it. Again, you can add *.orig to your .gitignore file or turn off this feature. Unfortunately, SourceTree does not have a GUI option for this, so fire up your git bash or, if you chose the right PATH option during installation, the Windows Command prompt and do this:
git config --global mergetool.keepBackup false
That will stop Git creating the *.orig files. You can also directly edit the config file by locating the .gitconfig file in the root of your user directory. If you know how to use VIM, you can edit the whole thing with this command:
git config --global --edit
Git 2.5+ (Q2 2015) will include Winmerge as a known git mergetool
!
If Winmerge is in your %PATH%
, a git config merge.tool winmerge
is all you need to do!
(It works for diff tool too: git config diff.tool winmerge
)
See commit 3e4f237 by David Aguilar (davvid
), 20 May 2015.
(Merged by Junio C Hamano -- gitster
-- in commit 324a9f4, 01 Jun 2015)
Helped-by: Philip Oakley (PhilipOakley
), Johannes Schindelin (dscho
), Sebastian Schuberth (sschuberth
), SZEDER Gábor (szeder
)
All the config is now done for you directly in Git itself, with mergetools/winmerge
:
- diff command:
"$merge_tool_path" -u -e "$LOCAL" "$REMOTE"
- merge command:
"$merge_tool_path" -u -e -dl Local -dr Remote "$LOCAL" "$REMOTE" "$MERGED"
mergetools
: add winmerge as a builtin toolAdd a winmerge scriptlet with the commands described in this thread, so that users can use winmerge without needing to perform any additional configuration.