Help: transplant

hg transplant [-s REPO] [-b BRANCH [-a]] [-p REV] [-m REV] [REV]...

transplant changesets from another branch

Selected changesets will be applied on top of the current working directory with the log of the original changeset. The changesets are copied and will thus appear twice in the history with different identities.

Consider using the graft command if everything is inside the same repository - it will use merges and will usually give a better result. Use the rebase extension if the changesets are unpublished and you want to move them instead of copying them.

If --log is specified, log messages will have a comment appended of the form:

(transplanted from CHANGESETHASH)

You can rewrite the changelog message with the --filter option. Its argument will be invoked with the current changelog message as $1 and the patch as $2.

--source/-s specifies another repository to use for selecting changesets, just as if it temporarily had been pulled. If --branch/-b is specified, these revisions will be used as heads when deciding which changesets to transplant, just as if only these revisions had been pulled. If --all/-a is specified, all the revisions up to the heads specified with --branch will be transplanted.

Example:

  • transplant all changes up to REV on top of your current revision:
    hg transplant --branch REV --all
    

You can optionally mark selected transplanted changesets as merge changesets. You will not be prompted to transplant any ancestors of a merged transplant, and you can merge descendants of them normally instead of transplanting them.

Merge changesets may be transplanted directly by specifying the proper parent changeset by calling 'hg transplant --parent'.

If no merges or revisions are provided, 'hg transplant' will start an interactive changeset browser.

If a changeset application fails, you can fix the merge by hand and then resume where you left off by calling 'hg transplant --continue/-c'.

(use 'hg help -e transplant' to show help for the transplant extension)

options ([+] can be repeated):

-s --source REPO transplant changesets from REPO
-b --branch REV [+] use this source changeset as head
-a --all pull all changesets up to the --branch revisions
-p --prune REV [+] skip over REV
-m --merge REV [+] merge at REV
--parent REV parent to choose when transplanting merge
-e --edit invoke editor on commit messages
--log append transplant info to log message
--stop stop interrupted transplant
-c --continue continue last transplant session after fixing conflicts
--filter CMD filter changesets through command
--mq operate on patch repository

global options ([+] can be repeated):

-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
--color TYPE when to colorize (boolean, always, auto, never, or debug)
--config CONFIG [+] set/override config option (use 'section.name=value')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: UTF-8)
--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
--pager TYPE when to paginate (boolean, always, auto, or never) (default: auto)