git-diff-pairs(1) Manual Page

パッチを生成します([generate_patch_text_with_p] 参照)。

diff 機構からの出力をすべて抑制します。 デフォルトでパッチを表示する git show のようなコマンドで出力を抑制したり、 コマンドラインのエイリアスで --patch や --stat などのオプションの効果をキャンセルしたりする場合に便利です。

通常の3行ではなく、 <n> 行の内容で diff を生成します。 --patch の機能を含んでいます。

stdout ではなく指定のファイルに出力します。

生成されたパッチの新しい行、古い行、またはコンテキスト行を示すために使用される文字を指定します。 通常、それらはそれぞれ "+", "-", " " です。

生形式(raw format)でdiffを生成します。 これがデフォルトです。

-p --raw の同義語。

diffハンクの境界をずらす(shift)ヒューリスティックを有効にして、パッチを読みやすくします。 これがデフォルトです。

インデントヒューリスティック(indent heuristic)を無効にします。

より多くの時間を費やして、可能な限り最小のdiffが生成されるようにします。

"patience diff" アルゴリズムを使用してdiffを生成します。

"histogram diff" アルゴリズムを使用してdiffを生成します。

"anchored diff" アルゴリズムを使用してdiffを生成します。

diffアルゴリズムを選択します。そのバリエーションは以下のとおりです:

diffstat を生成します。 デフォルトでは、 必要なだけのスペースがファイル名部分に使用され、 残りはグラフ部分に使用されます。 最大幅はデフォルトで端末幅、 または端末に接続されていない場合は 80 桁であり、 <width> で上書きできます。 ファイル名部分の幅は、 カンマの後に別の幅 <name-width> を指定するか、または diff.statNameWidth=<name-width> を設定することによって制限できます。 グラフ部分の幅は、 --stat-graph-width=<graph-width> を使用するか、 または diff.statGraphWidth=<graph-width> を設定することによって制限できます。 --stat または --stat-graph-width の使用は統計グラフを生成するすべてのコマンドに影響しますが、 diff.statNameWidth または diff.statGraphWidth の設定は git format-patch には影響しません。 3番目のパラメータ <count> を指定することにより、出力を最初の <count> 行に制限し、それに ... が続く形にできます。

ファイルの作成や削除( "new" または "gone" 。オプションでシンボリックリンクの場合は +l )、 diffstat のモード変更(実行可能ビットを追加または削除する場合は、それぞれ +x または -x )など、 拡張ヘッダー情報の要約を出力します。 情報はファイル名部分とグラフ部分の間に置かれます。 本機能は --stat の機能を含んでいます。

--stat に似ていますが、プログラムで処理しやすい(machine friendly)ように、追加および削除された行数を10進表記とパス名で省略形なしで表示します。バイナリファイルの場合、 0 0 の代わりに2つの - を出力します。

変更されたファイルの総数と、追加および削除された行の数を含む --stat 形式の最後の行のみを出力します。

各サブディレクトリの相対的な変更量の分布を出力します。 --dirstat の動作は、パラメータのコンマ区切りリストを渡すことでカスタマイズできます。デフォルトは、 diff.dirstat 構成変数によって制御されます(git-config(1) 参照)。以下のパラメータを使用できます:

--dirstat=cumulative と同義語。

--dirstat=files,<param>,... と同義語。

作成、名前変更、モード変更などの拡張ヘッダー情報の短い要約(condensed summary)を出力します。

-p --stat と同義語。

--raw または --numstat または --name-only または --name-status が指定されている場合は パス名を変更せず、出力フィール・ターミネーターとしてNULLを使用してください。

ポスト・イメージ・ツリー(post-image tree)に、 変更された各ファイルの名前のみを表示します。 多くの場合、ファイル名はUTF-8でエンコードされます。 詳細については、 git-log(1) のマニュアルページにあるエンコーディングに関する議論(the discussion about encoding)を参照してください。

変更された各ファイルの名前とステータスのみを表示します。 ステータス文字の意味については、 --diff-filter オプションの説明を参照してください。 --name-only と同じように、ファイル名はしばしばUTF-8でエンコードされます。

サブモジュールの違いをどのように表示するかを指定します。 --submodule=short を指定する場合、 short形式が使用されます。この形式は、範囲の最初と最後にコミットの名前を表示するだけです。 --submodule または --submodule=log が指定されている場合、 log形式が使用されます。この形式では、 git-submodule(1) の summary のように範囲内のコミットが一覧表示されます。 --submodule=diff が指定されている場合、 diff形式が使用されます。この形式は、コミット範囲間のサブモジュールの内容の変更のインラインdiffを示します。configオプションが設定されていない場合、デフォルトは diff.submodule または short 形式です。

色付きのdiffを表示します。 --color (つまり、 =<when> 無し) は --color=always と同じです。 <when> は、 always または never または auto のいずれかになります。

カラーdiffをオフにします。 --color=never と同じです。

ソースコードの移動した行を別の色にします。 <mode>は、オプションが指定されていない場合はデフォルトで no になり、 モードが指定されていないオプションが指定されている場合は zebra になります。 モードは以下のいずれかでなければなりません:

移動検出をオフにします。 これは、構成設定を上書きするために使用できます。 --color-moved=no と同じです。

これは、 --color-moved の移動検出を実行するときに空白を無視する方法を設定します。 これらのモードは、コンマ区切りのリストとして指定できます:

移動検出を実行するときは、空白(whitespace)を無視しないでください。これは、構成設定を上書きするために使用できます。 --color-moved-ws=no と同じです。

デフォルトでは、単語は空白(whitespace)で区切られます。 以下の --word-diff-regex を参照してください。 <mode> のデフォルトは plain です。 <mode> は以下のいずれかである必要があります:

空白以外を単語と見なす代わりに、 <regex> を使用して単語が何であるかを決定します。また、すでに有効になっていない限り、この機能は --word-diff の機能を含んでいます。

--word-diff=color に --word-diff-regex=<regex> を加えたものに相当します(正規表現が指定されている場合)。

構成ファイルにデフォルトで指定されている場合でも、名前変更の検出をオフにします。

名前変更ソースとして空のブロブを使用するかどうか。

変更によって競合マーカーまたは空白エラーが発生した場合に警告します。空白エラーと見なされるものは、 core.whitespace 構成によって制御されます。 デフォルトでは、末尾の空白(空白のみで構成される行を含む)と、行の最初のインデント内で直後にタブ文字が続くスペース文字は、空白エラーと見なされます。問題が見つかった場合は、ゼロ以外のステータスで終了します。なお、 --exit-code とは互換性がありません。

diffの context または old または new 行の空白エラーを強調表示します。複数の値はコンマで区切られ、 none は前の値をリセットし、 default はリストを new にリセットし、 all は old、new、context の省略形です。このオプションが指定されておらず、構成変数 diff.wsErrorHighlight が設定されていない場合、 new 行の空白エラーのみが強調表示されます。空白エラーは color.diff.whitespace で色分けされています。

パッチ形式の出力を生成するときは、最初の一握りの文字(first handful of characters)の代わりに、「インデックス」行にイメージ前およびイメージ後の完全ブロブオブジェクト名を表示します。

--full-index に加えて、 git-apply で適用できるバイナリ差分を出力します。 --patch の機能を含んでいます。

完全な40バイトの16進オブジェクト名をdiff-raw形式の出力とdiff-treeヘッダー行に表示する代わりに、オブジェクトを一意に参照する、少なくとも <n> 桁の16進数の長さの最短のプレフィックスを表示します。diffパッチ出力形式では、 --full-index が優先されます。つまり、 --full-index が指定されている場合、 --abbrev に関係なく、完全なブロブ名が表示されます。デフォルト以外の桁数は、 --abbrev=<n> で指定できます。

完全な書き換えの変更を削除と作成のペアに分割します。これには以下の2つの目的があります:

名前の変更(renames)を検知する。 n が指定されている場合、それは類似性インデックスのしきい値です (つまり、ファイルのサイズと比較した追加/削除の量)。 たとえば、 -M90% は、ファイルの90%以上が変更されていない場合、 Gitが削除/追加のペアを名前変更と見なす必要があることを意味します。 % 記号がない場合、数値は小数として読み取られ、その前に小数点が付きます。 つまり、 -M5 は0.5になるため、-M50% と同じになります。 同様に、 -M05 は -M5% と同じです。 検出を正確な名前変更に制限するには、 -M100% を使用します。 デフォルトの類似性インデックスは50%です。

名前変更と同様にコピーを検出します。 --find-copies-harder も参照してください。 n を指定すると、 -M<n> と同じ意味になります。

パフォーマンス上の理由から、デフォルトでは、 -C オプションは、コピーの元のファイルが同じ変更組(changeset)で変更された場合にのみコピーを検索します。このフラグにより、コマンドは変更されていないファイルをコピー元の候補として検査します。これは大規模なプロジェクトでは非常にコストのかかる操作であるため、注意して使用してください。 複数の -C オプションを指定しても同じ効果があります。

削除するプレイメージ(preimage)を省略します。つまり、ヘッダーのみを出力し、プレイメージと /dev/null の差分は出力しません。結果のパッチは、 patch または git apply で適用されることを意図していません。これは、変更後にテキストを確認することに集中したい人のためだけのものです。さらに、出力には明らかに、そのようなパッチを手動でも逆に適用するのに十分な情報が不足しているため、このようなオプション名になっています。

-M および -C オプションには、名前変更/コピーのサブセットを安価に検出できるいくつかの準備手順が含まれ、その後に、残りのすべてのペアになっていない比較先(destinations)をすべての関連ソースと比較する徹底的なフォールバック部分が続きます。(名前の変更の場合、残りのペアになっていないソースのみが関係します。コピーの場合、すべての元のソースが関係します)。N個の、ソースと比較先の場合、この徹底的なチェックのコストは O(N^2) です。このオプションは、関係するソース/比較先ファイルの数が指定された数を超えた場合に、名前変更/コピー検出の完全な部分が実行されないようにします。デフォルトは diff.renameLimit です。 値0は無制限として扱われることに注意してください。

追加(Add)・コピー(Copy)・削除(Delete)・変更(Modify)・名前変更(Rename)されたファイル、タイプが変更されたファイル(T)、マージされていないファイル(U)、不明なファイル(X)、またはペアリングが壊れているファイル(B)のみを選択します。フィルタ文字(無しも含む)の任意の組み合わせを使用できます。 組み合わせに * (全てまたは無し)が追加されると、比較で他の基準に一致するファイルがある場合、すべてのパスが選択されます。 他の基準に一致するファイルがない場合、何も選択されません。

ファイル内の指定の <string> (つまり、 addition 、deletion)の出現回数の差分を調べます。 スクリプトで使用することを目的としています。

パッチテキストに <regex> にマッチする 追加/削除 された行が含まれている差分を探します。

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

指定されたオブジェクトの出現回数を変更する違いを探します。 -S と同様に、引数だけが異なり、特定の文字列ではなく特定のオブジェクトIDを検索します。

-S または -G が変更を見つけたら、 <string> の変更を含むファイルだけでなく、その変更セット(changeset)のすべての変更を表示します。

-S に指定した <string> を拡張POSIX正規表現として扱います。

ファイルが出力に表示される順序を制御します。これは diff.orderFile 構成変数をオーバーライドします(git-config(1) 参照)。 diff.orderFile をキャンセルするには、 -O/dev/null を使用します。

名前で指定した <file> より前のファイルを出力から破棄(つまり、 そこまでスキップ)するか、 または、 それらのファイルを出力の末尾に移動させます。 これらオプションは主に git difftool コマンドでの使用目的のために考案されたものであり、そ れ以外の場合はあまり役に立たない可能性があります。

2つの入力を交換します。 つまり、インデックスまたはディスク上のファイルとツリーの内容の違いを表示します。

プロジェクトのサブディレクトリから実行する場合、このオプションを使用して、ディレクトリ外の変更を除外し、それに関連するパス名を表示するように指示できます。サブディレクトリ(ベアリポジトリなど)にいない場合は、引数として <path> を指定することで、出力を作成するサブディレクトリに名前を付けることができます。 --no-relative は、 diff.relative 設定オプションと以前の --relative の両方を打ち消すために使用できます。

すべてのファイルをテキストとして扱います。

比較を行うときは、行末のキャリッジリターン(carriage-return)を無視します。

行末(EOL)での空白(whitespace)の変更を無視します。

空白(whitespace)の数の変更は無視してください。これは、行末の空白(whitespace)を無視し、1つ以上の空白文字(whitespace characters)の他のすべてのシーケンスを同等と見なします。

行を比較するときは空白を無視します。 これにより、一方の行に空白があり、もう一方の行に空白がない場合でも、違いは無視されます。

全て空白の行の変更は無視します。

すべての行が <regex> にマッチする変更を無視します。このオプションは複数回指定できます。

指定された行数(<number>)までの diff ハンク間のコンテキストを表示し、 それによって互いに近いハンクを融合します。 デフォルトは diff.interHunkContext で、 構成オプションが設定されていない場合は 0 です。

関数全体を各変更のコンテキスト行として表示します。関数名は、 git diff がパッチハンクヘッダーを処理するのと同じ方法で決定されます(gitattributes(5) の「Defining a custom hunk-header」参照)。

diff(1）と同様のコードでプログラムを終了させます。つまり、違いがあった場合は 1 で終了し、 0 は違いがないことを意味します。

プログラムのすべての出力を無効にします。 --exit-code を含んでいます。 終了コード(exit code)が信頼できない、 つまり、 構成オプション diff.trustExitCode または diff.<driver>.trustExitCode または 環境変数 GIT_EXTERNAL_DIFF_TRUST_EXIT_CODE のいずれかが false の場合、 外部 diff ヘルパーの実行を無効にします。

外部diffヘルパーの実行を許可します。 gitattributes(5) を使用して外部diffドライバーを設定する場合は、 git-log(1) およびその仲間と一緒にこのオプションを使用する必要があります。

外部diffドライバーを禁止します。

バイナリファイルを比較するときに、外部テキスト変換フィルターの実行を許可(または禁止)します。 詳細については、 gitattributes(5) を参照してください。textconvフィルターは通常、一方向の変換であるため、結果のdiffは人間の消費に適していますが、適用(apply)することはできません。このため、textconvフィルターは、 git-diff(1) および git-log(1) に対してのみデフォルトで有効になりますが、 git-format-patch(1) またはdiff配管コマンドに対しては有効になりません。

diff 生成時にサブモジュールへの変更を無視します。 all がデフォルトです。 none を使用すると、追跡されていないファイルまたは変更されたファイルが含まれている場合、またはそのHEADがスーパープロジェクトに記録されているコミットと異なる場合にサブモジュールが変更されたと見なされ、 git-config(1) または gitmodules(5) の ignore オプションの設定をオーバーライドするために使用できます。 untracked が使用されている場合、サブモジュールには追跡されていないコンテンツのみが含まれている場合、サブモジュールはダーティとは見なされません(ただし、変更されたコンテンツはスキャンされます)。 dirty を使用すると、サブモジュールの作業ツリーへのすべての変更が無視され、スーパープロジェクトに格納されているコミットへの変更のみが表示されます(これは1.7.0までの動作でした)。 all を使用すると、サブモジュールへのすべての変更が非表示になります。

"a/" の代わりに、指定した比較元プレフィックス(source <prefix>)を表示します。

"b/" の代わりに、指定した比較先プレフィックス(destination <prefix>)を表示します。

比較元(source)または比較先(destination)のプレフィックスを表示しません。

デフォルトの比較元(source)および比較先(destination)のプレフィックスを使用します("a/" と "b/")。 これは、 diff.noprefix や diff.srcPrefix や diff.dstPrefix や diff.mnemonicPrefix などの設定をオーバーライドします(git-config(1) 参照)。

出力のすべての行に追加のプレフィックス(<prefix>)を付加します。

デフォルトでは、 git add -N によって追加されたエントリは、 git diff に既存の空のファイルとして表示され、 git diff --cached に新しいファイルとして表示されます。このオプションを使用すると、エントリは git diff では新しいファイルとして表示され、 git diff --cached では存在しません。このオプションは、 --ita-visible-in-index で元に戻すことができます。どちらのオプションも実験的なものであり、将来削除される可能性があります。

コマンドラインで指定された各パス指定(pathspec)について、 ディレクトリの深さを最大 <depth> 階層までしか辿らない。 値に -1 を指定すると制限なしとなる。 パス指定にワイルドカードを含んでいる場合は併用できない。 ツリーに foo/bar/baz が含まれている場合の例を以下に示す: