Help: merge

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

merge working directory with another revision

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 with must be provided.

"hg resolve" must be used to resolve unresolved files.

To undo an uncommitted merge, use "hg update --clean ." 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.


-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)
-t --tool VALUE specify merge tool

global options:

-R --repository REPO repository root directory or name of overlay bundle file
--cwd DIR change working directory
-y --noninteractive do not prompt, automatically pick the first choice for all prompts
-q --quiet suppress output
-v --verbose enable additional output
--config CONFIG [+] set/override config option (use '')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: ascii)
--encodingmode MODE set the charset encoding mode (default: strict)
--traceback always print a traceback on exception
--time time how long the command takes
--profile print command execution profile
--version output version information and exit
-h --help display help and exit
--hidden consider hidden changesets

[+] marked option can be specified multiple times