TortoiseMerge はフリー・オープンソースアプリケーションです。テキストファイルの差分を表示、変更点のマージ、パッチ とよく呼ばれる unified diff ファイルの検査・適用を行います。

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

バージョン管理システム (例: Subversion) を利用して作業を行っていると、作業コピーの更新時に 競合 することがあります。これは作業を行ったファイルのある部分に対して、他の誰かが同じ部分を変更したことによって起こります。この競合は手動で解決しなければなりません。TortoiseMerge はこの作業を助けてくれます。

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

図1.1 ファイルの競合

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

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

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

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

パッチファイルを適用する GUI ツールをインターネットで探すのに長時間費やしましたが、そのようなツールがありませんでした。はしょって言うと、そんなツールがないのなら自分たちで作ってしまおうということです。そうして TortoiseMerge が生まれました。

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

このモードでは、2 つのファイルを比較できます。左ペインのファイルをオリジナルファイル (時に Theirs として参照) として扱い、右ペインのファイル (Mine として参照) を変更したファイルとして扱います。

右ペインにあるファイルに対して、以下のことを含む、単純な行ベースの変更を行うことができます。

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

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

図2.1 ファイルの競合

ベースファイルは You と They が変更を始めた、ファイルの最も古いバージョンを表します。Mine はベースファイルに対して you が行ったすべての変更があるファイルを表します。また、Theirs は 他人 が行ったすべての変更があるファイルを表します。左ペインはベースファイルに対する Theirs の変更を表示します。また、右ペインはベースファイルに対する Mine の変更を表示します。下ペインには、競合を解決しようとしている出力ファイルです。

競合解決ビューでは、Mine や Theirs もしくは両方から、採用するブロックを選択できます。しかし、この場合、変更は下部ペインに表示します。

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

いずれの場合も、TortoiseMerge はパッチに含まれるファイルを表示する、小さなウィンドウを表示します。その中のファイルをダブルクリックすると、関連ファイルを取得し、変更を適用します。左ペインにはオリジナルファイルの内容を表示し、右ペインにはパッチを適用した結果を表示します。

比較・編集モードで、右ペインに対して編集を行えます。

TortoiseMerge は、以下の 3 つのビューモードを持っています。1 ペインビュー、2 ペインビュー、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 パッチをあてるファイル一覧

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

でも、ご心配なく。Subversion で作業していれば、古いバージョンのファイルを取り出し、競合を解消できます。実際、TortoiseMerge は自動で古いバージョンのファイルを取り出し、Base (古いバージョンのファイル)、Mine (現在作業コピーにあるファイル)、Theirs (古いバージョンのファイルにパッチが当たったファイル) の差分を表示します。以上から手動で競合を解消できます。

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

TortoiseMerge がパッチを直接適用できるか、まず古いバージョンを取得してから適用するかによって、2 ペイン表示 (直接適用) か 3 ペイン表示 (古いバージョンの取得) で表示します。

図3.5 ツールバー

メニューバーの下にツールバーがあります。ツールに共通な機能に簡単にアクセスできるようにします。

ウィンドウの左側にあるのは位置指定バーです。これにより、ファイルにある変更点を素早く参照できます。位置指定バーは 3 列あります。左の列は左ペインを、右の列は右ペインを、中央の列は (表示されている場合) 下部ペインを参照します。1 ペインビューでは左の列のみ使用します。位置指定バーは、ウィンドウを同時にスクロールさせるスクロールバーとしても、使用できます。

下部ウィンドウの下は、ステータスバーです。Theirs と Mine の追加・削除行数や、解消されていない競合数を表示します。また、使用している改行スタイルや、TortoiseMerge が仮定した文字のエンコード (ASCII, UTF-8, など)、UTF-8 のファイルのバイトオーダマーク (BOM) の有無も表示します。ステータスバーの左側は、マウスでコントロールを指す際に、ヒントを表示するのに使用します。

変更のある行は、どのような変更が行われたかを表すアイコンで、マーク付けがなされます。

追加した行です。

削除した行です。

オリジナルな内容に戻して、変更されていない行です。

この行には空白の変更しかありません。連続した行がマークされている場合、単語が隣接行に移されて、再度折り返しが行われた可能性があります。

追加した行です。

競合のある行です。

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

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

2 ペインビューの場合、右ペイン (Mine) のみ編集できます。左のファイル (Theirs) に変更を加えるには、変更する行で 右クリック し、コンテキストメニュー → 「theirs」 のテキストブロックを利用 を選択してください。その後、左のファイルの変更を右のファイルに加えてください。

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

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

3 ペインビュー (時に マージビュー と呼ばれます) の場合、下部ビューにあるファイル (Merged) のみ編集できます。2 ペインビューと同様に、競合した行で 右クリック し、コンテキストメニュー → 「theirs」 のテキストブロックを利用 と コンテキストメニュー → 「mine」 のテキストブロックを利用 のどちらかを選択してください。さらに 両方 のブロックを使用したい場合は、コンテキストメニュー → 「theirs」 の前に 「mine」 のテキストブロックを利用 と コンテキストメニュー → 「mine」 の前に 「theirs」 のテキストブロックを利用 のどちらかを選択してください。選択したコマンドの結果、Merged ファイルを変更します。

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

競合によっては、Theirs と Mine から選択するだけで解消するわけに行かず、手で編集しなければならないことがあります。TortoiseMerge は、まず簡単な変更を行ってしまってから保存し、手で編集して解消する難しい変更のみにできます。

コマンドラインスイッチを指定せずに TortoiseMerge を起動すると、ファイル → 開く を使用して、自分でファイルを開かなければなりません。

図3.6 開くダイアログ

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