Merging in MercurialΒΆ
Sometimes you will need to fix conflicts when merging files. In Mercurial there
are a number of different options which you can use for handling merging, and
you can set your preferred one in the ~/.hgrc
file. The options fall
into two categories internal merging or tool merging.
Internal merging marks the files with the <<<<<
,
>>>>>
, and =======
symbols denoting the position of the conflict
in the file and you resolve the changes on your terminal. The following
example sets Meld as the merge handler.
[ui]
merge = internal:merge
Tool merging differs slightly depending on the tool you use, but they will all do the same thing. Highlight the conflict area in some manner, and allow you to make the necessary changes to resolve the conflicts. Set a merge tool using the following example.
[merge-tools]
meld3.executable = /usr/local/bin/meld
For more detailed information, see the Getting Started with VCS section, or the Mercurial merge-tools documentation. Use the following example steps to handle merging conflicts.
- Check the list of conflicts on the command line, in this example
you can see the list as the
default
andstable
branches are in the process of being merged.
$ hg branch
stable
$ hg merge default
note: using 4480fbc4562c as ancestor of 7c9a8dfb9dd6 and fbefb727a452
alternatively, use --config merge.preferancestor=a1e8bd6df0ce
merging default.nix
merging docs-internal/changelog.rst
merging rhodecode/VERSION
merging rhodecode/controllers/api/utils.py
warning: conflicts during merge.
merging rhodecode/controllers/api/utils.py incomplete!
(edit conflicts, then use 'hg resolve --mark')
merging rhodecode/lib/diffs.py
merging rhodecode/model/scm.py
merging rhodecode/tests/api/test_utils.py
warning: conflicts during merge.
merging rhodecode/tests/api/test_utils.py incomplete!
(edit conflicts, then use 'hg resolve --mark')
merging rhodecode/tests/models/test_scm.py
warning: conflicts during merge.
merging rhodecode/tests/models/test_scm.py incomplete!
(edit conflicts, then use 'hg resolve --mark')
merging vcsserver/default.nix
merging vcsserver/vcsserver/VERSION
42 files updated, 7 files merged, 2 files removed, 3 files unresolved
use 'hg resolve' to retry unresolved file merges or 'hg update -C .' to abandon
- Open each of the highlighted files, and fix the conflicts in each. Each merge
conflict will look something like the following example, with the
<<<<<
,>>>>>
, and=======
symbols denoting the position of the conflict in the file. You need to fix the content so that it is correct.
# Change this example conflict
def pre_request(worker, req):
<<<<<<<<<<<<<<
worker.log.debug("[%s] PRE WORKER: %s" %(worker.pid, req.method))
===============
worker.log.debug("[%s] PRE WORKER: %s %s" % (worker.pid, req.method,
req.path))
>>>>>>>>>>>>>>
# To this working code
def pre_request(worker, req):
worker.log.debug("[%s] PRE WORKER: %s %s" % (worker.pid, req.method,
req.path))
- Once you have finished fixing the conflicts, you need to mark them as resolved, and then commit the changes.
# Mark the merges as resolved
$ hg resolve --mark
# Commit the changes
$ hg commit -m "merge commit message"
- Once you have finished your merge, if the the original repository history on
the server is different you have two options:
- Push with force using
hg push --force
which will create a new head. - Strip your commits on the server back to a previous revision, and then push
the new history. To strip commits on the server, see the
strip
information in the API Documentation documentation.
- Push with force using