左右のファイル ペインには、比較対象の 2 つのファイルのテキスト内容と相違点が表示されます。ファイル ペインは、差異に移動したりマージしたりするためのメイン領域であり、テキストを直接編集することもできます。このセクションでは、これらのアクションをサポートする機能と、ファイル ペインをカスタマイズする方法について説明します。

2.1.6. ファイルペインのマージン

ファイル ペインには、行番号といくつかの記号を表示するオプションの灰色の余白があります。余白を表示または非表示にするには、表示 → 余白の表示 をクリックします。複数のファイル比較ウィンドウを使用している場合は、各ウィンドウのマージンを個別に制御できます。マージンには、次の機能の一部またはすべてが表示されます。

• 行番号 (表示 → 行番号の表示 が有効な場合)。

• ブックマーク (編集 → ブックマーク が有効な場合)。ブックマークは、行の隣の余白にある青い円で、WinMerge に記憶させて戻ることができます。

  • 行にブックマークを設定するには、その行の余白をダブルクリックします (または Ctrl+F2 を押します)。同じ操作で既存のブックマークも削除されます。

  • ブックマークを移動するには、編集 → ブックマーク をクリックし、次へ または 前 を選択します。

  • 単一のブックマークをダブルクリックして削除します (または、Ctrl+F2 を押します)。

  • 編集 → ブックマーク → すべてのブックマークをクリア をクリックしてすべてのブックマークを削除します。

• ワードラップ矢印記号 (表示 → 折り返す が有効な場合)。

次のスクリーンショットは、ブックマークとワードラップが有効になっているマージンを示しています。行番号がない場合、余白幅は最小限になります。

次のスクリーンショットは、ブックマークと行番号が有効になっているマージンを示しています。余白が広くなっていることに注目してください。実際、マージンは最大行番号に対して十分広いです。したがって、行数が多い大きなファイルの余白は非常に広くなる可能性があります。

WinMerge ツールバーとメニューには、ファイル内の相違点を移動、選択、マージするためのさまざまな機能が用意されています。

使用できる差異機能はコンテキストによって異なり、作業中に変化することがよくあります。これは、WinMerge 環境の特定の場所またはその他の条件でその操作が可能な場合にのみ機能が使用可能であることを意味します。たとえば、差異内のテキスト行をクリックすると、ツールバーでいくつかのナビゲーション ボタンとマージ ボタンが有効になることに気づく場合があります。差異内にないテキストの別の領域をクリックすると、これらの機能は使用できなくなります。

差異機能は、WinMerge ツールバーで使用できるほか、次の代替メカニズムでも使用できます。

差異機能については、このトピックの後半の 「差異への移動」 および 「差異のマージ」 で説明します。 クイックスタート と ファイル比較とマージの概観 には、比較とマージの例が示されています。

3つのテキストファイルを比較し、マージ結果の出力先を指定した場合（例えば、バージョン管理ツールがコマンドラインオプション /o を指定して WinMerge を起動した場合）、ファイル比較ウィンドウの下部にマージ結果ペインが表示されます。これは KDiff3 のマージ出力ウィンドウと同様に動作します。3つのファイルペインには比較対象のファイルが読み取り専用で表示され、マージ結果ペインにはマージ結果が表示され、自由に編集できます。この機能を使用するには、オプションダイアログの「比較/マージ」ページでマージ結果ペインを有効にする必要があります。

2方向の競合ファイルを ファイル → 競合ファイルを開く で開くと、マージ結果ペインが有効な場合、WinMerge は2つのソースペインを左右に並べて表示し、マージ結果ペインを開きます。2方向の競合ファイルには共通のベースがないため、差異のある各ブロックは未解決の状態で始まります。ブロックを解決するには、左または右のソースを選択します。このモードでは、ツールバーのボタンには 1 と 2 の番号が付けられ、Ctrl+Shift+1 と Ctrl+Shift+2 で、それぞれ左と右のソースを選択できます。未解決のブロックは、標準的な2方向の競合マーカーを使用して保存されます。

ペインを開くと、すべての差異は最初は未解決の状態になり、簡略化された<マージコンフリクト>または<未解決の差異>というプレースホルダー行で表示されます。/al、/am、/arコマンドラインオプション、または自動マージコマンドで自動マージを実行すると、コンフリクトしていない差異は選択したマージ先に従って自動的に解決され、ベースに対して両側で同じ行が変更された真のコンフリクトだけが未解決のまま残ります。

差異を解決するには、その差異を選択し、最上位の マージ結果 メニューから使用するソースを選択します。2方向マージセッションでは 左を選択 と 右を選択 が使用でき、3方向マージセッションでは、さらに 中央を選択 も使用できます。また、マージ結果ペインのコンテキストメニューや、ツールバーの 1 / 2 / 3 ボタンも使用できます。各コマンドは、現在の差異（または現在の選択範囲に含まれるすべての差異）に対して、対応するペインの行の選択と解除を切り替えます。複数のペインを選択すると、選択した順序でそれぞれの行が結合されます（両側で追加された内容をマージ結果に両方とも残したい場合に便利です）。すべてのペインの選択を解除すると、その差異は再び未解決の状態になります。また、未解決の差異を除き、マージ結果ペインに直接入力して修正することもできます。未解決の差異は、テキストを編集する前に、いずれかの「選択」コマンドを使用して解決する必要があります。左右の内容が空白文字のみ異なる競合には、（空白文字のみ） と表示されます。

ペインのマージンには各行の出所が表示されます。左、中央、右のペインから取得した行には、それぞれ1、2、3（ツールバーボタンに対応）が表示され、未解決のコンフリクトセクションには?、手動で変更された差異にはmが表示されます。ペインのステータスバーには、まだ未解決の差異の数が表示されます。ペインを開いている間は、次のコンフリクトおよび前のコンフリクト（Alt+Shift+Down／Alt+Shift+Up）を使用すると、すでに解決された差異を飛ばして、まだ判断が必要な次または前の差異に移動できます。

ファイル → 保存 → マージ結果を保存、保存ツールバーボタン、またはCtrl+Sを使用して、結果を出力先に保存します。未解決の差異が残っている場合、WinMergeは警告を表示します。未解決のコンフリクトはプレースホルダーテキストではなく、標準的なコンフリクトセクションとして保存されます。そのため、ファイルにはコンフリクトしている行のすべてのバージョンが保持され、後で任意のエディターやマージツールで処理を完了できます。コンフリクトしていない未解決の差異は、自動マージされた内容で保存されるため、どのバージョン管理システムも生成しないようなコンフリクトマーカーが出力に含まれることはありません。出力先のファイルをそのまま再度開いても、これらのコンフリクトセクションからマージを再開することはありません。他の3方向マージツールと同様に、WinMergeは常に比較対象の3つのファイルからマージ結果を再構築します。そのため、バージョン管理ツールが/oコマンドラインオプション（たとえばgit mergetool）を指定してWinMergeを再度起動すると、出力ファイルにすでに何が含まれているかにかかわらず、毎回新しいマージが実行されます。以前に部分的に解決したコンフリクトファイルから作業を再開するには、ファイル → コンフリクトファイルを開くを使用します。WinMergeはそのコンフリクトセクションを解析し、未解決の差異として復元するとともに、すでに解決されていたテキストを保持します。ウィンドウを閉じるときには、マージ結果が未保存の場合にもWinMergeは保存を確認します。これは、その時点でマージ結果ペイン自体が非表示になっている場合も同様です。デフォルトでは、各行は元の改行コードを保持して保存されるため、出力は元のファイルとの差異ができるだけ少なくなります（たとえば、バージョン管理での差分を最小限にできます）。出力の改行コードは、マージ結果ペインのステータスバーからWindows、Unix、またはクラシックMac形式に変更できます。エンコーディングは変更を行った側に従い、保存時にはバックアップファイルのオプションと、ファイルを開く際に使用したファイルパッカープラグインが適用されます。

3方向のテキスト比較では、マージ → マージセッションを開始（差異は未解決の状態で開始）またはマージ → 自動マージ（コンフリクトしていない差異は自動的に解決）を使用して、マージを開始することもできます。マージセッションがアクティブな間は、表示 → マージ結果ペインを使用してペインを表示または非表示にできます。マージセッションを終了して通常の3ペインの編集可能な状態に戻すには、マージ → マージセッションを終了を選択します。マージ結果に未保存の変更がある場合、WinMergeは保存を確認し、各ペインの元の読み取り専用状態とヘッダーを復元します。

ファイル ペインの左側にあるロケーションペインでは、比較されるファイルの全長が 2 つの垂直バー (左右のファイル ペインに対応) にマップされます。これは、長すぎて [ファイル] ペイン内で簡単に移動できないファイルを操作する場合に特に便利です。

[場所] ペインには、いくつかの種類の項目が表示されます。

[場所] ペインのコンテキスト メニューには、次のショートカットが含まれています:

差異ペインには、選択した差異の両側の内容が表示されます。

差異を選択すると、2 つのバージョンが差異ペインの上部と下部にロードされます。このように、差異ペインでは差異にどの行が含まれているかを確認し、ファイルの残りの部分から切り離してそれらの行を調べることができます。

[差異] ペインで差異を直接マージするには、上側または下側を右クリックし、右側にコピー または 左側にコピー を選択します。

各ファイル ペインの下部にはステータス バーが含まれています。ステータス バーには、ドキュメントとドキュメント内の位置に関するさまざまな種類の情報を含むいくつかのペインが含まれています。

ファイル比較ウィンドウが開いているとき、WinMerge ウィンドウのステータス バーには、比較されたファイルに関する次のいずれかのメッセージが表示されます。

[ファイル比較] ウィンドウで相違点をナビゲートするための機能と、ツールバーとメニューのショートカットを次に示します。

デフォルトでは、WinMerge オプションのエディター ページで 自動再スキャン オプションが有効になっています。再スキャンにより、比較およびマージ操作が最新の状態に保たれます。再スキャンしない場合、WinMerge 差異は、外部エディタなどでファイルを比較しているときにファイルに発生する可能性のある変更を検出しません。

再スキャンは、ファイル比較中に特定のアクション (差異のマージやファイルの編集など) を実行すると発生します。ファイルが変更されている場合、WinMerge は別のアプリケーションがファイルを更新したことを通知するダイアログを表示し、ファイルを再ロードするかどうかを尋ねます。

はいをクリックしてファイルを再ロードしてから続行するか、いいえをクリックして変更を無視し、以前にロードされたファイルのバージョンで作業します。

マージ機能は、カーソル位置またはテキスト選択に基づいて相違点を暗黙的に選択できます。たとえば、差異内の任意の場所をクリックしてから、ツールバーの 右側にコピー ボタンをクリックすると、差異ブロック全体がマージされます。これにより、多くの小さな違いを簡単にマージできます。同様に、複数の相違点のすべてまたは一部にまたがるテキストを選択すると、含まれるすべての相違点が 1 つのマージ コマンドでマージされます。

マージ操作の結果が期待したものと異なる場合は、元に戻す をクリックして操作を元に戻すことができます。

ツールバーとメニューのマージ機能とそのショートカットは次のとおりです。

WinMerge を使用すると、一部のバージョン管理システムがマージ操作中に生成する競合ファイルを解決できます。コンフリクトファイルは、マージで自動的に解決できない差異が発生した場合に作成されます。これは、2 つのファイルの不完全にマージされたコンテンツを含む 1 つのファイルです。 WinMerge はコンフリクトファイルを個別のファイルに分割し、それらのファイルをファイル比較ウィンドウで開きます。その後、WinMerge の比較およびマージ機能を使用してコンフリクトを解決し、マージされた結果ファイルを保存できます。

多くのバージョン管理システムでは、外部マージ ツールを構成できます。そうであれば、マージコンフリクトが発生したときにバージョン管理システムで WinMerge を自動的に起動できる可能性があります。

また、WinMerge コマンド ラインからコンフリクトファイルを開くこともできます。このコマンド ラインでは、Theirs、Mine、およびオプションで Resolved (コンフリクトファイルとは異なる結果ファイルが必要な場合) の 3 つのファイル名パラメータを受け入れます。詳細については、「コマンドライン」を参照してください。コンフリクトファイルへの単一パスもコマンド ラインで受け入れられます。