7
時々、ブランチの変更の全部ではなく一部だけを選んでマージすることが\
9
これは一般的に *チェリーピッキング(cherrypicking)* として言及されます。
11
チェリーピッキングが役に立ついくつかの事例:
13
* メインの開発ブランチから修正の一部を取り出してリリースブランチに取り込む
15
* 実験ブランチから改善内容を選別して機能ブランチに取り込む
17
``foo`` ブランチのリビジョン Xによってなされた変更のみをマージするためには::
21
``foo`` ブランチのリビジョンXまでの変更のみをマージするためには::
25
``foo`` のリビジョンX以降の変更のみをマージするためには::
29
``foo`` ブランチのリビジョンXからリビジョンYまでの変更のみをマージするには::
33
通常のマージと同じように、チェリーピックは明示的にコミットしなければなりません。
34
これを行う前に、 ``bzr diff`` を利用した変更を見て何かあればテストスイートを\
37
通常のマージとは異なり、Bazaarは現在はチェリーピックを追跡しません。
38
具体的に言うと、変更は通常のコミットと同じようになり、他のブランチから来た(内部の)変更履歴は失われます。
39
上記のようなチェリーピックが役に立つ場面では、このことはたいてい重大な問題ではありません。
40
フルマージが後で行われることはけっしてないと言える十分な理由があるからです。
41
そうではない場面では、変更が再びマージされたときにまた衝突を解消する必要があります。
43
.. _reverse-cherrypicking:
46
---------------------------
48
チェリーピッキングは一連の変更を元に戻すことができます。この場合、リビジョン範囲の\
49
上界(upper bound)が下界(lower bound)よりも *小さく* なります。
50
たとえば、リビジョン10の変更を取り消すためのコマンドはこうなります::
54
どこかから、すべてではない大半の変更を得たい場合通常のマージをした後に少しの\
55
リバースチェリーピックを行うとよいでしょう。
59
-------------------------------------
61
複数のブランチを持っており、間違えて別のブランチを変更し始めた場合、訂正をとるステップは次のとおりです。
62
ブランチ ``bar`` で作業したかったのに、ブランチ ``foo`` で作業を始めてしまったという場合を前提とします:
65
2. ``bzr merge --uncommitted foo`` を実行する
66
3. やってくる変更をチェックする (``bzr diff``)
68
5. ``bzr revert`` を実行する
70
.. TODO Selective file merging?
76
通常のマージの別のオプションは *リベース(rebase)* です。
77
すなわち、現在のブランチが本来とは異なる地点をベースにするようにします。
78
リベースは ``rebase`` プラグインによって提供される ``rebase`` コマンド\
81
``rebase`` コマンドは現在の作業ディレクトリ内のリベースされるブランチ上で\
83
ブランチが指定されないと親のブランチが使われ、通常これは望まれる結果です。
85
最初のステップは現在のブランチのものであるが親のブランチではないリビジョンを\
87
現在のブランチはターゲットブランチと同じリビジョンに設定され、それぞれの\
88
リビジョンはブランチのトップで再現されます。
89
プロセスの終了時に現在のブランチがターゲットの最終リビジョンからブランチ\
92
再現されるそれぞれのリビジョンがツリーの中で衝突を起こすことがあります。
93
これが起きたらコマンドは停止してそれらを修正しなければなりません。
94
``merge`` するためにコミットを解消し、それらが解消されたものとしてマークするために
95
``bzr resolve`` を実行します。
96
すべての衝突を解消したら、リベースオペレーションを続けるために ``bzr rebase-continue``
98
衝突に遭遇せず続けないことを決めたら、 ``bzr rebase-abort`` を実行できます。
99
リプレイされるコミットの一覧を表示するために ``rebase-todo`` を利用することもできます。
101
注: マージトラッキング機能が貧弱なVCSツールから来たユーザーの中にはリベースを好む人がいます。
102
古いツールでの作業方法に似ている、もしくは"完璧にきれいな" 履歴が重要だからです。
103
Bazaarでリベースする前に、通常のマージがベターな選択肢ではないのか考えてください。
104
とりわけ、始める前にプライベートなブランチをリベースするのは大丈夫ですが、
105
他の誰かとブランチを共有した後のリベースは **強く非推奨** です。
added
removed
doc/ja/user-guide/adv_merging.txt
