18.10 Diffモード

Diffモードは、M-x diffや他の同様なコマンドの出力のために使用されるメジャーモードです。この種の出力はpatchと呼ばれます。なぜならそれが特定の変更を自動的に適用するために、patchコマンドに渡されるからです。手動でDiffモードを選択するには、M-x diff-modeとタイプします。

パッチに指定された変更は、hunk(欲張り)にグループ化されます。これは変更された行を１行以上含むテキストと、それに隣接するテキストです。hunksには変更のコンテキストを提供するために、変更されていない行も含むことができます。それぞれのhunkにはhunkヘッダーが前についていて、これはhunkが出現する古い方の行番号と、新しい行番号が指定されます。Diffモードは実際のhunkの内容と区別するため、hunkヘッダーをハイライトします。

他のバッファーと同様に、Diffモードのバッファーを編集することができます(もし読み込み専用の場合、最初にそれを書き込み可にする必要があります。Misc Bufferを参照してください)。hunkを変更すると、Diffモードはpatchを“正しい”状態に保つために、hunkヘッダーの行番号を自動的に修正しようと試みます。自動的な行番号の修正を無効にするには、変数diff-update-on-the-flyをnilに変更してください。

DiffモードはCompilationモードと同様に、各hunkを“エラーメッセージ”として扱います。したがってC-x 'のようなコマンドを使って、対応するソースの位置をvisitすることができます。

それに加えてDiffモードは、移動、操作、patchの一部を適用するために、以下のコマンドを提供します:

M-n

次のhunkが開始される位置に移動します(diff-hunk-next)。

このコマンドには副作用があります。これは移動先のhunkをrefines(不純物を取り除く)して、よりよい粒度で変更をハイライトします。この機能を無効にするにはM-x diff-auto-refine-modeとタイプして、マイナーモードのDiff Auto-Refineモードをオフに切り替えます。デフォルトでDiff Auto-Refineモードを無効にするには、以下をinitファイルに追加します(Hooksを参照してください):

(add-hook 'diff-mode-hook
          (lambda () (diff-auto-refine-mode -1)))

M-p

前のhunkが開始される位置に移動します(diff-hunk-prev)。これはM-nと同様、Diff Auto-Refineモードが無効でなければ、移動先のhunkをrefiningする副作用があります。

M-}

複数ファイルへのpatchで、次のファイルが開始される位置に移動します(diff-file-next)。

M-{

複数ファイルへのpatchで、前のファイルが開始される位置に移動します(diff-file-prev)。

M-k

ポイントがある位置のhunkをkillします(diff-hunk-kill)。

M-K

複数ファイルへのpatchで、現在のファイル部分をkillします(diff-file-kill)。

C-c C-a

このhunkを対象ファイルに適用します(diff-apply-hunk)。プレフィクス引数C-uを指定すると、このhunkを復元します。

C-c C-b

ポイント位置のhunkの変更を、よりよい粒度でハイライトします(diff-refine-hunk)。これにより変更された各行について実際に変更された箇所を確実に見ることができます。

C-c C-c

このhunkに対応するソースファイルの行へジャンプします(diff-goto-source)。

C-c C-e

このパッチでEdiffセッションを開始します。Ediff in The Ediff Manualを参照してください。

C-c C-n

表示を現在のhunkに制限します(diff-restrict-view)。Narrowingを参照してください。プレフィクス引数C-uを指定すると、複数ファイルへのpatchで、表示を現在のファイルに制限します。制限を解除するには、C-x n w (widen)を使います。

C-c C-r

バッファー全体の比較方向を逆転します(diff-reverse-direction)。

C-c C-s

ポイント位置でhunkを分割します(diff-split-hunk)。これは手動でpatchを編集するためのもので、diffプログラムに-uまたは--unifiedオプションを指定して生成された、unified diff format(統一diffフォーマット)だけで機能します。diffに-cまたは--contextオプションを指定して生成された、context diff format(コンテキストdiffフォーマット)のhunkを分割するには、最初にC-c C-uで、バッファーをunified diff formatに変換する必要があります。

C-c C-d

バッファー全体を、context diff formatに変換します(diff-unified->context)。プレフィクス引数を指定すると、リージョンのテキストだけを変換します。

C-c C-u

バッファー全体をunified diff formatに変換します(diff-context->unified)。プレフィクス引数を指定すると、unified formatからcontext formatに変換します。マークがアクティブのときは、リージョンのテキストだけを変換します。

C-c C-w

現在のhunkをrefineするので、空白文字の変更を無視します(diff-refine-hunk)。

C-x 4 A

それぞれのhunkについて、C-x 4 aが行うようにChangeLog(Change Logを参照してください)のエントリーを生成します(diff-add-change-log-entries-other-window)。これは、あとで実際に変更の説明を記入できるように、変更ログの雛形を作ります。DiffモードでのC-x 4 a自体は、現在のhunkのファイルのためのものですが、関数名はpatch自体から取得します。これはpatchにより削除される関数のための、ログエントリーを作るのに有用です。

patchには変更された行の行末に、無意識に入力された望んでいない空白文字が含まれている場合があります。この問題を扱うには2つの方法があります。1つ目はDiffバッファーでWhitespaceモード(Useless Whitespaceを参照してください)を有効にする方法で、これは自動的に変更された行の行末にある空白文字をハイライトします。2つ目はコマンドM-x diff-delete-trailing-whitespaceを使う方法で、patchにより変更された行の行末の空白文字を検索して、patchとpatchされたソースファイルの両方からそれを取り除きます。このコマンドは変更を保存しないので、ユーザーが変更を保存するか決定することができます(変更されたファイルはエコーエリアに表示されます)。プレフィクス引数を指定すると、patchされたファイルではなく、元のソースファイルを変更しようと試みます。