TortoiseMerge はフリーでオープンソースのアプリケーションです。テキストファイルの差分を表示したり、変更点をマージしたり、 パッチ と呼ばれる Unified 差分ファイルを検査したり適用したりすることができます。

任意のプログラム言語のソースファイルや、ドキュメントや Web サイトの html/xml ファイルといったテキストファイルで作業していると、そのファイルの異なるバージョンと比較したくなる状況があるでしょう。他の誰かが行ったバージョンとの差分を得たり、自分がどのような変更を行ったか見るといったことです。

Subversion のようなバージョン管理システムを使用して作業を行っていると、作業コピーを更新する時に 競合 が発生することがあります。これは、作業コピーに変更を加えた部分と同じ部分に対して、他の誰かが別の変更を加えたことによって発生します。競合は手作業で解決しなければなりません。 TortoiseMerge はこの作業を助けてくれます。

競合時のファイルの関係を、以下の図に示します。

図1.1 ファイルの競合

古くなってしまったパッチファイルを適用しようとしたときにも、競合が発生します。この場合 TortoiseMerge を使用しなければ、現在のバージョンに対するパッチファイルがないか人に尋ねたり、パッチファイルを手作業で適用してみたりする必要があるでしょう。

しかし TortoiseMerge を使えば、もうこのようなことは必要ありません（少なくとも Subversion のようなバージョン管理システムを使用していないのであれば）。 TortoiseMerge はパッチを作成したリビジョン・バージョンを解析し、バージョン管理システムから特定のバージョンを自動的に取得します。その後パッチを適用し、自分の行った変更と他人の行った変更の両方を確認できるようにします。これにより、変更点を保持するかどうか決めることができます。

TortoiseSVN の作業をしていると、プロジェクトの拡張やバグの修正のためのパッチを送ってもらったときにはいつも、そのパッチを適用するのに大量の作業を行わなければなりませんでした。また多くの場合、既にファイルを更新してしまっていたために、そのパッチは時代遅れになっており、コマンドラインパッチツール http://unxutils.sourceforge.net/ では適用できませんでした。

また、 TortoiseSVN がもともと TortoiseSVN → パッチの作成 を実装していなかった主な理由でもあるのですが、パッチの適用が簡単だったので、私たちはユーザーがファイル全体を送ってくれるのを歓迎していました。

長時間を費やしてパッチファイルを適用することができる GUI ツールをインターネットで探しましたが、そのようなツールは存在しないということが分かっただけでした。その後は省略しますが、そのようなツールを提供してくれる人がいないのであれば、自分たちで作らなければならないと思い立ちました。そうして TortoiseMerge が生まれました。

TortoiseSVN は既にすばらしい差分エンジンを内蔵した Subversion のライブラリを使用していたので、 GNU diff の代わりにこのライブラリを使用するのは自然なことでした。

このモードでは、２つのファイルを比較できます。左画面のファイルはオリジナルファイル（Theirs とも呼ばれる）として扱われ、右画面のファイルは変更後のファイル（Mine とも呼ばれる）として扱います。

右画面にあるファイルに対しては、単なる行単位の変更に加え、次のような操作を行うことができます。

また、右画面のファイルはテキストエディターのように編集することもできます。その行は鉛筆アイコンで印がつけられます。なお、前述の行単位やブロック単位の変更を行うつもりなら、編集する前に行っておく方がよいでしょう。編集してしまうと、 TortoiseMerge が オリジナルファイルとの関連を追跡できなくなります。

これは3方向マージと呼ばれ、3画面表示になります。しかし、実際には4つのファイルが関係しています。現在競合している２つのファイルの共通の祖先である、共通のベースファイルは表示されません。3つのファイルの関係は、以下の図で説明します。

図2.1 ファイルの競合

ベースファイル（Base）は、 自分 と 他人 がそのファイルに対して変更を始めた、最も古いバージョンを表します。 Mine は Base ファイルに対して自分が変更した結果を表します。また、 Theirs は 他人 が変更した結果を表します。左画面には、ベースファイルに対する Theirs の変更が表示されます。また、右画面には、ベースファイルに対する Mine の変更を表示します。下画面には、競合を解決した結果を出力するファイルが表示されます。

競合の解決画面では、 Mine や Theirs もしくは両方から、採用するブロックを選択できます。この場合、変更結果は下の画面に表示されます。

パッチファイルは Subversion の Unified 差分ファイルで、変更を適用するファイルの一覧が含まれています。パッチは、あなたが変更点を確認してからコミットできるように、他の開発者によって作成されたかもしれません。また、 TortoiseSVN が２つのフォルダーを比較する際に、内部的に作成したかもしれません。これは、リポジトリのリビジョンと作業コピーのフォルダーを比較したり、リポジトリ内の２つのリビジョンを比較したり、２つの異なるリポジトリパスを比較したりすると発生します。

いずれの場合も、パッチに含まれるファイルの一覧が、小さいウィンドウで表示されます。その中のファイルをダブルクリックすると、関連するファイルが取得され、変更が適用されます。左画面にはパッチ適用前の、右画面にはパッチ適用後のファイルの内容が表示されます。

比較・編集モードと同様に、右画面のファイルを編集することができます。

TortoiseMerge は、1画面表示、2画面表示、3画面表示の3つの表示モードを持っています。1・2画面表示は変更を表示するために、3画面表示は競合を解決するために使用します。

表示・マージ

図3.1 1画面表示

図3.2 2画面表示

2画面表示には、1画面表示にはない次のような特徴があります。

• 変更のあった行内の変更点が、違う色で表示されます。文字列が追加された部分は明るい色になりますが、もちろんここで使用する色は設定できます。削除された部分は暗い茶色表示され、文字列に取り消し線が入ります。どのように動作するかは、上のスクリーンショットで確認してください。

• コードを再編成すると、ホワイトスペース（空白、タブ、改行）を大量に変更しても、コードには実質的に変更がないことがあります。例えば、非常に長い行を数行に分割したり、短い複数の行をひとつにまとめたりした場合です。

  このような変更は、画面の左端に白い円が表示されます。このような白い円がある場合には、実質的にはその部分のコードに変更がなく、変更箇所のチェックを行う必要がないことがすぐにわかります。

• 2画面表示では、右画面のファイルを手作業で編集できます。変更した場所には鉛筆マークが表示されます。左画面がアクティブな時に編集を有効化を押した場合のみ、左画面も手作業で編集できます。

3つのファイルを比較・マージする場合、 TortoiseMerge は3画面表示で差分を表示します。ファイルの競合を解決する必要があるときにも便利です。

図3.3 3画面表示

左画面には Their ファイルと Base ファイルの差異が表示され、右画面には Mine ファイルと Base ファイルの差異が表示されます。下画面には、 Base、 Mine、 Theirs をマージした結果が発生しうる競合と共に表示されます。

画面のタイトル部分にマウスを置くと、どちらの画面でも差分を取っているファイル名がツールチップに表示されます。

左画面と右画面は、アクティブな時に編集を有効化を押した場合のみ、手作業で編集できます。

パッチの適用

TortoiseMerge がパッチファイルを解釈すると、そのパッチファイルで変更されるファイルを表示する、小さなウィンドウが表示されます。

図3.4 パッチを適用するファイル一覧

ファイル名が黒で表示されている場合、問題なくパッチを当てることができます。これはパッチがそのファイルに対して古くなっているわけではないということを表します。しかし、ファイル名が赤で表示されている場合、既にファイルが変更されているため、直接パッチを当てることができません。

パッチファイルウィンドウにはコンテキストメニューがあり、現在のファイルにパッチを適用した結果をプレビュー（保存せず適用）したり、選択したファイルのみ適用して保存したり、一覧にあるファイルすべてに適用・保存を行うといった操作ができます。ダブルクリックするとプレビューします。

設定によっては、多くのボタンが表示されたツールバーやリボンが表示されます。各ボタン上でマウスポインターを停止すると、機能を説明するツールチップが表示されます。

ウィンドウの左側にはロケーターバーがあります。これによって、ファイル中のどこに変更があるのかを概観することができます。ロケーターバーは3列あります。左の列は左画面を、右の列は右画面を、中央の列は（表示されている場合）下画面を表しています。1画面表示時は左の列のみ表示されます。ロケーターバーは、各画面を同時にスクロールさせるスクロールバーとしても使用できます。

単語をダブルクリックすると、文書中の単語の出現位置が、メイン画面とロケーターバーの両方で強調表示されます。強調表示を解除するには、もう一度単語をダブルクリックします。

左マージンをクリックしたり、行をトリプルクリックしたりすると、行全体を選択することができます。

下部ウィンドウの下にはステータスバーがあります。 Theirs と Mine の追加・削除行数や、解決されていない競合数が表示されます。また、使用されている改行文字や、 TortoiseMerge が検出した文字エンコード（ASCII、 UTF-8、 など）、 UTF-8 のファイルのバイトオーダマーク（BOM）の有無も表示されます。改行文字や文字エンコードは、この表示の該当する列をダブルクリックすることで変更することができます。ダイアログボックスが表示されます。ステータスバーの左側には、マウスでコントロールを指した時にヒントが表示されます。

変更された行は、どのような変更が行われたかがアイコンで表示されます。

追加された行です。

削除された行です。

変更を取りやめ、元の内容に戻された行です。

この行は空白しか変更されていません。マークが連続している箇所では、段落の折り返し位置が変更されて、単語が隣の行に移動しているかもしれません。

TortoiseMerge をテキストエディターとして使用して、手作業で編集された行です。

競合のある行です。

競合がありますが、空白や改行の設定により効果が見えない行です。

他の場所との間で行単位の移動が検出された行です。

TortoiseMerge はファイルの差分を 表示 するだけでなく、競合を解決したり変更を適用したりすることができます。

2画面表示の場合、右画面（Mine）のみ編集できます。左のファイル（Theirs）に変更を加えるには、変更する行で右クリックし、コンテキストメニュー → 「theirs」のテキストブロックを使用を選択してください。そうすれば、左のファイルからの変更が右のファイルに加えられます。

時には、両方のテキストブロックが必要になる場合があります。その場合は、 コンテキストメニュー → 両方のテキストブロックを使用（こちらを前にする） や コンテキストメニュー → 両方のテキストブロックを使用（こちらを後にする） を使用してください。

また、テキストエディターのように出力ファイルを編集することもできます。その行は鉛筆アイコンで印がつけられます。なお、前述の行/ブロックベースの変更を行うつもりなら、編集する前に行っておいた方がよいでしょう。編集してしまうと、TortoiseMerge が オリジナルファイルとの関連を追跡できなくなります。

3画面表示（ マージビュー とも呼ばれる）の場合、下画面にあるファイル（マージ後）のみ編集できます。2画面表示と同様に、競合した行で 右クリック し、 コンテキストメニュー → 「theirs」のテキストブロックを使用 と コンテキストメニュー → 「mine」のテキストブロックを使用 のどちらかを選択してください。さらに両方のブロックを使用したい場合は、 コンテキストメニュー → 「theirs」の前に「mine」のテキストブロックを使用 と コンテキストメニュー → 「mine」の前に「theirs」のテキストブロックを使用 のどちらかを選択してください。選択したコマンドの結果が、マージ後ファイルに反映されます。

時には、TortoiseMerge では競合していないのに、Subversion で競合が発生したと印がつけられることがあります。これは、選択した空白の扱いによるものかもしれません。行末や空白の変更を無視するようにした場合、その行は 競合無視 アイコンを用いて印がつけられます。競合を解決するために、どのバージョンを採用するか選択する必要があります。

コマンドラインスイッチを指定せずに TortoiseMerge を起動した場合は、 ファイル → 開く を使用して手作業でファイルを開いてください。

図3.5 開くダイアログ

まず始めにあなたがすることは、ファイルの比較・マージをしたいのか、パッチを適用したいのかを決めることです。その選択により、該当するエディットボックスやブラウズボタンが有効になります。