hg graft [OPTION]... [-r REV]... REV...

копировать изменения с другой ветки в текущую

Эта команда использует возможности слияния Mercurial, чтобы скопировать отдельные изменения из других веток без полного слияния веток в графе истории. Иногда эту операцию также называют 'бэкпортирование' ('backporting') или 'cherry-picking'. По умолчанию graft копирует имя автора, даты и описание из ревизии-источника.

Наборы изменений, являющиеся предками текущей ревизии, и к которым уже была применена операция graft, а также ревизии слияния будут пропущены.

Если указан --log, к журнальным сообщениям будет добавлен комментарий вида:

(перенесено из ХЭШРЕВИЗИИ)

If --force is specified, revisions will be grafted even if they are already ancestors of, or have been grafted to, the destination. This is useful when the revisions have since been backed out.

Если во время операции graft возникает конфликт, операция отменяется для того, чтобы текущее слияние было завершено вручную. После разрешения всех конфликтов, можно продолжить процесс с помощью параметра -c/--continue.

The -c/--continue option reapplies all the earlier options.

The --base option exposes more of how graft internally uses merge with a custom base revision. --base can be used to specify another ancestor than the first and only parent.

The command:

hg graft -r 345 --base 234

is thus pretty much the same as:

hg diff --from 234 --to 345 | hg import

but using merge to resolve conflicts and track moved files.

The result of a merge can thus be backported as a single commit by specifying one of the merge parents as base, and thus effectively grafting the changes from the other side.

It is also possible to collapse multiple changesets and clean up history by specifying another ancestor as base, much like rebase --collapse --keep.

The commit message can be tweaked after the fact using commit --amend .

For using non-ancestors as the base to backout changes, see the backout command and the hidden --parent option.

Примеры:

• скопировать одно изменение в ветку stable и отредактировать ее описание:

  hg update stable
  hg graft --edit 9393
  

• перенести диапазон ревизий с одним исключением, обновляя даты:

  hg graft -D "2085::2093 and not 2091"
  

• продолжить перенос после разрешения конфликтов:

  hg graft -c
  

• показать источник перенесенного набора изменений:

  hg log --debug -r .
  

• show revisions sorted by date:

  hg log -r "sort(all(), date)"
  

• backport the result of a merge as a single commit:

  hg graft -r 123 --base 123^
  

• land a feature branch as one changeset:

  hg up -cr default
  hg graft -r featureX --base "ancestor('featureX', 'default')"
  

See 'hg help revisions' for more about specifying revisions.

Returns 0 on successful completion, 1 if there are unresolved files.

options ([+] can be repeated):

global options ([+] can be repeated):