NAME¶

hg merge - merge another revision into working directory

SYNOPSIS¶

hg merge [-P] [[-r] REV]

DESCRIPTION¶

The current working directory is updated with all changes made in the requested revision since the last common predecessor revision.

Files that changed between either parent are marked as changed for the next commit and a commit must be performed before any further updates to the repository are allowed. The next commit will have two parents.

--tool can be used to specify the merge tool used for file merges. It overrides the HGMERGE environment variable and your configuration files. See hg help merge-tools for options.

If no revision is specified, the working directory's parent is a head revision, and the current branch contains exactly one other head, the other head is merged with by default. Otherwise, an explicit revision with which to merge must be provided.

See hg help resolve for information on handling file conflicts.

To undo an uncommitted merge, use hg merge --abort which will check out a clean copy of the original merge parent, losing all changes.

Returns 0 on success, 1 if there are unresolved files.

OPTIONS¶

-f, --force

force a merge including outstanding changes (DEPRECATED)

-r,--rev <REV>

revision to merge

-P, --preview

review revisions to merge (no merge is performed)

--abort

abort the ongoing merge

-t,--tool <TOOL>

specify merge tool