#language ja

== Rebase エクステンション ==
'''現在、このエクステンションは Mercurial とともに配布されています。'''

''作者: Stefano Tortarolo''

== 設定 ==

設定ファイル(例えば `.hg/hgrc`)でエクステンションを有効にしてください:
{{{
[extensions]
rebase =
}}}

== はじめに ==
プロジェクトに貢献するときに、いくつかのパッチは非公開にしたまま、リポジトリ全体を最新の状態に保ちたい場合があります。

そういう場合には、一度手元の変更を"デタッチ"して、リポジトリをメインストリームと同期したあと、手元の変更をリモートから取得した最新の変更の上に追加するのが有効です。この手順を ''rebase(リベース)'' と呼びます。

一般に、このエクステンションを使って、リビジョンをある地点から別の地点に移動することができます。良くあるパターンを、"シナリオ" セクションで説明しています。

== 機能 ==
 * 単純なリベース、複雑なリベース
 * 中断したリベースの中止
 * 中断したリベースの再開
 * 中断時の変更の検出

== 使い方 ==
=== 概要 ===
{{{
   hg rebase [--source REV | --base REV] [--dest REV] [--collapse] [--detach] [--keep] [--keepbranches] | [--continue] | [--abort]
}}}

== 説明 ==
 * '''--source''' rev
   指定したリビジョンとその子孫リビジョンがリベース先に移動されます。

 * '''--base''' rev
   指定したリビジョンとリベース先リビジョンの共通の祖先から、指定したリビジョンおよびその子孫リビジョンが、リベースの対象になります。(共通の祖先自身は除きます)
   ''--sourceと同時に指定することはできないことに注意してください''

 * '''--dest''' rev
   指定されたリビジョンの上に、リベース対象のリビジョンが移動されます。

 * '''--continue'''
   中断したリベースを再開します。

 * '''--abort'''
   中断したリベースを中止します。

 * '''--collapse'''
   リベースされるリビジョンをまとめます。

 * '''--keep'''
   元のリビジョンをリベース後も残します。

 * '''--keepbranches'''
   元のブランチ名を引き継ぎます。

 * '''--detach''' '''''(Mercurial 1.6以降)'''''
   リベース対象のリビジョンを強制的に元のブランチから切り離します。
   ''訳注：このオプションは、現在非推奨です。''

=== pullコマンドとの統合 ===
このエクステンションによって、pullコマンドにオプションが追加されます。
{{{
   hg pull --rebase
}}}
これを指定すると、もしリベースするべきリビジョンが手元にある場合はプル後にリベースされ、なければhg pull --updateと同様の動作をします。

== 一般的なケース ==
このエクステンションを引数なしで実行することができるというのは重要なポイントです。

意味的には、引数なしのリベースは、 ''自分が今作業しているブランチを取って、正しい状態にする'' ことであると言えます。言い換えると、手元で行った変更を、チェックアウト中の名前つきブランチの最新HEAD上に移動することを意味します。

次のようなシチュエーションを考えてみましょう。:

{{{#!dot
digraph {
  rankdir=LR
  node [shape=box]
  C1 -> C2 -> L1 -> L2
}
}}}
L* は、最後にプルしてから手元で行った変更を表しています。

{{{
hg pull
}}}
メインストリームから、新しいリビジョンを２つプルしました。

{{{#!dot
digraph {
  rankdir=LR
  node [shape=box]
  C1 -> C2 -> L1 -> L2
  node [color=green];
  C2 -> R1 -> R2
}
}}}
たいてい、ここでやりたいのは L* を R2 の上に移動することです。それは、以下のように簡単にできます。:

{{{
hg rebase
}}}
結果:

{{{#!dot
digraph {
    rankdir=LR;
    node [shape=box];

    C1 -> C2 -> R1 -> R2;
    node [color=red];
    R2 -> L1 -> L2;
    L1 [label="L1 '"];
    L2 [label="L2 '"];
}
}}}
'''Note:''' 前述の通り, これは '''''hg pull --rebase''''' で１アクションで実行できます。

== 衝突するマージの扱い ==
L* における変更が R* における変更と衝突することがあります。その場合、エクステンションは停止し、現在の状態を保存して、ユーザ自身が衝突を解消できるようにします。

リベースが中断したときには、２つの選択肢があります。:

 * 中止
 * 続行

=== 中止 ===
以下のコマンドで、中断されている処理は中止され、リポジトリは元の状態に戻ります。:

{{{
$ hg rebase --abort
}}}
=== 続行 ===
しかし、中断されている処理を再開する方が一般的です。それは以下のコマンドで出来ます:

{{{
$ hg rebase --continue
}}}

== リベースが出来ない場合 ==
リベースができないシチュエーションがいくつかあります。:

 * リベースポイント(リベース元)がリベース先の祖先の場合
 * リベースポイント(リベース元)がリベース先の子孫の場合
 この場合は、 [[TransplantExtension|transplant]] や [[MqExtension|strip]] コマンドを使う必要があります。例えば:
 {{{
hg up -r <targetrev>  # Needed because the transplant -m option doesn't work
hg transplant <source>:tip
hg strip <source>
}}}

 * リベース元(source)がマージリビジョンで、その親がどちらも外部にある場合

 /* XXX:externalの意味がよく分からない: the rebasing point (source) is a merge revision and both of its parents are external */

== MQパッチに関する注意事項 ==
現在の実装では、MQパッチはqfinishされ、リベース後にqimportされます。これによって、exportのようなヘッダがリベースされたパッチに追加されます。例えば、

 * 元のパッチ:
 {{{
Description P0

diff --git a/f b/f
etc...
}}}

 * リベース後のパッチ:
 {{{
# HG changeset patch
# User Stefano Tortarolo <stefano.tortarolo@gmail.com>
# Date 1217929313 -7200
# Node ID 92bd85e9196feac01fdf2eb2ce7275e9a575a730
# Parent  6e55161e68b2062d629c05b89b0ea3424eec9a2f
Description P0

diff --git a/f b/f
etc...
}}}

== シナリオ ==
ここからは、もっと興味深いシナリオを分析していきましょう。

=== シナリオ A ===
最初は、もっとも単純なパターンの、シンプルブランチです。

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> D -> E;
    A -> B -> C;
}
}}}
このシナリオでは、２つの興味深い相互作用があります。

==== トップへのリベース ====

{{{
$ hg up C
$ hg rebase -d E
}}}
{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> D -> E;
    node [color=red];
    E -> B -> C;
    B [label="B '"];
    C [label="C '"];
}
}}}
以下のやり方でも同じ結果になります。:
{{{
$ hg up E
$ hg rebase -s C
}}}

==== 中間リビジョンへのリベース ====

{{{
$ hg up C
$ hg rebase -d D
}}}
{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> D -> E;
    node [color=red];
    D -> B -> C;
    B [label="B '"];
    C [label="C '"];
}
}}}

=== シナリオ B ===
２番目のシナリオには、もっと複雑なパターンが含まれます。このシナリオでは、アップストリームからクローンし、何度かマージを行っています。

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> C -> E -> F -> I;
    A -> B -> D -> G -> H;
    C -> D;
    F -> H;
}
}}}

==== Iの上にDをリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> C -> E -> F -> I;
    A -> B;
    node [color=red];
    I -> D -> G;
    B -> D;
    D [label="D '"];
    G [label="G '"];
}
}}}
 . D はマージリビジョンですが、 H と違って '''スキップ''' されません。

==== Iの上にBをリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> C -> E -> F -> I;
    node [color=red];
    I -> B -> G;
    B [label="B '"];
    G [label="G '"];
}
}}}
 . この場合は、２つのリビジョン(D と H)はスキップされます。

==== Bの上にCをリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> B;
    node [color=red];
    B -> C -> E -> F -> I;
    C -> G -> H;
    F -> H;

    C [label="C '"];
    E [label="E '"];
    F [label="F '"];
    I [label="I '"];
    G [label="G '"];
    H [label="H '"];
}
}}}

==== Iの上にGをリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> C -> E -> F -> I;
    A -> B -> D;
    C -> D;
    node [color=red];
    D -> G;
    I -> G;
    G [label="G '"];
}
}}}
'''Note:''' 親がリベース先の祖先の場合に '''限り''' 、リベースによって親との関係が削除されます。
'''''--detach''''' オプションを指定すると、強制的にこの関係を削除します。

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];

    A -> C -> E -> F -> I;
    A -> B -> D;
    C -> D;
    node [color=red];
    I -> G;
    G [label="G '"];
}
}}}

=== シナリオ C ===
このケースは、リポジトリがひとつだけの(マージされた)HEADを持つという、非常に一般的なシチュエーションを表しています。

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];
    A -> B -> C;
    A -> D -> E;
    C -> F;
    E -> F;
}
}}}

==== Cの上にDをリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];
    A -> B -> C;
    node [color=red];
    C -> D -> E;
    D [label="D '"];
    E [label="E '"];
}
}}}
 . 明らかに、リビジョン F はスキップされています。

=== 集約 ===
複数のチェンジセットを、ひとつだけのリビジョンとして別のブランチにリベースできると便利なこともあります。

これは '''''--collapse''''' を指定すればできます。

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];
    A -> B;
    A -> C -> D -> E;
}
}}}

==== Bの上にCを集約してリベース ====

{{{#!dot
digraph {
    node [shape=box];
    graph [rankdir=LR];
    A -> B;
    node [color=red];
    B -> CDE;
    CDE [label="C ' + D ' + E '"];
}
}}}

== 詳細 ==
=== 親リビジョンとの関係付け ===
与えられたノード('''N''') をリベースする際に、その親の状態によってことなる結果になることがあります。

ここからは、 P1,,N,, は '''N''' の一つ目の親、 P2,,N,, は二つ目の親を指すものとします。

例えば、 P1',,N,, は、リベースされた '''N''' の一つ目の親です。

それらのシチュエーションは、以下の表にまとめられます。:
|| ||||<style="text-align: center;">'''P2,,N,, = A''' ||||<style="text-align: center;">'''P2,,N,, = S''' ||||<style="text-align: center;">'''P2,,N,, = E''' ||||<style="text-align: center;">'''P2,,N,, = N''' ||
||'''P1,,N,, = A''' ||||<style="text-align: center;"> ||||<style="text-align: center;">p1 = P2',,N,, ||||<style="text-align: center;">p1 = target, p2 = P2,,N,, ||||<style="text-align: center;">p1 = target ||
||'''P1,,N,, = S''' ||||<style="text-align: center;">p1 = P1',,N,, ||||<style="text-align: center;">p1 = P1',,N,,, p2 = P2',,N,, ||||<style="text-align: center;">p1 = P1',,N,,, p2 = P2,,N,, ||||<style="text-align: center;">p1 = P1',,N,, ||
||'''P1,,N,, = E''' ||||<style="text-align: center;">p1 = target, p2 = P1,,N,, ||||<style="text-align: center;">p1 = P2',,N,,, p2 = P1,,N,, ||||<style="text-align: center;"> ||||<style="text-align: center;">p1 = target, p2 = P1,,N,, ||




A: リベース先の祖先 S: リベース対象内 E: 外部 N: なし

空のセルは、以下の場合にあたります。:

 * P1,,N,, = P2,,N,, = A は、 '''N''' もリベース先の祖先であることを意味しており、これはリベースできないパターンです。
 * P1,,N,, = P2,,N,, = E は、 '''N''' がマージされたリビジョンで、かつその親が両方ともリベース先の祖先でないことを意味しており、これもリベースできないパターンです。(アイデア: もっといいリビジョン位置を仮定することは可能？) このケースは '''N''' がリベースポイントの場合にだけ発生することに注意してください。

以下のことも注意してください:

 * P1,,N,, = None の場合、必然的に P2,,N,, = None になります。
 * P1,,N,, = P2,,N,, = None になるのは、 '''N''' がルートの場合だけです。(この場合は、ノードを自分の子孫の上にリベースできないというルールにより禁止されます)

== コマンドのヘルプ ==

Mercurial 2.0では、以下がrebaseコマンドの公式なドキュメントです。
{{{
    Rebase uses repeated merging to graft changesets from one part of history
    (the source) onto another (the destination). This can be useful for
    linearizing *local* changes relative to a master development tree.

    You should not rebase changesets that have already been shared with
    others. Doing so will force everybody else to perform the same rebase or
    they will end up with duplicated changesets after pulling in your rebased
    changesets.

    If you don't specify a destination changeset ("-d/--dest"), rebase uses
    the tipmost head of the current named branch as the destination. (The
    destination changeset is not modified by rebasing, but new changesets are
    added as its descendants.)

    You can specify which changesets to rebase in two ways: as a "source"
    changeset or as a "base" changeset. Both are shorthand for a topologically
    related set of changesets (the "source branch"). If you specify source
    ("-s/--source"), rebase will rebase that changeset and all of its
    descendants onto dest. If you specify base ("-b/--base"), rebase will
    select ancestors of base back to but not including the common ancestor
    with dest. Thus, "-b" is less precise but more convenient than "-s": you
    can specify any changeset in the source branch, and rebase will select the
    whole branch. If you specify neither "-s" nor "-b", rebase uses the parent
    of the working directory as the base.

    By default, rebase recreates the changesets in the source branch as
    descendants of dest and then destroys the originals. Use "--keep" to
    preserve the original source changesets. Some changesets in the source
    branch (e.g. merges from the destination branch) may be dropped if they no
    longer contribute any change.

    One result of the rules for selecting the destination changeset and source
    branch is that, unlike "merge", rebase will do nothing if you are at the
    latest (tipmost) head of a named branch with two heads. You need to
    explicitly specify source and/or destination (or "update" to the other
    head, if it's the head of the intended source branch).

    If a rebase is interrupted to manually resolve a merge, it can be
    continued with --continue/-c or aborted with --abort/-a.
}}}

== 関連リンク ==
 * RebaseProject
 * RebasePlan
 * [[http://code.google.com/soc/2008/hg/appinfo.html?csaid=EC7D811E53CA98EF|GSoC's Abstract ]]
 * RebaseIfExtension - (Mercurialに同梱はされていない)別のエクステンション。衝突がない場合だけリベースを行い、衝突するときはマージを行う。
----
CategoryJapanese

[[RebaseExtension|English]]