gitrevisions(7) Manual Page

完全なSHA-1オブジェクト名(40バイトの16進文字列)、またはリポジトリ内で一意の先頭のsubstring。例えば dae86e1950b1277e545cee180551750029cfe735 と dae86e はどちらも、リポジトリ内にオブジェクト名が dae86e で始まる他のオブジェクトがない場合、全く同じコミットオブジェクトに名前を付けます。

git describe からの出力。つまり、現在のコミットから最も近いタグ。オプションで、ダッシュ(-)とそのタグ以降現在のコミットが何番目になるかの数が続き、その後にダッシュ(-)、「g」、および省略されたオブジェクト名が続きます。

シンボリックref名。例えば master は通常、 refs/heads/master によって参照されるコミットオブジェクトを意味します。 heads/master と tags/master の両方がある場合は、あなたは heads/master と明示的に指定して、どちらを意味するかをGitに伝えることができます。 あいまいな場合、 <refname> は、以下のルールでの最初の一致を採用することにより明確になります:

@ 単独では HEAD のショートカットを意味します。

refの後に接尾辞 @ が続き、日付指定が中括弧のペアで囲まれています(例: {yesterday} 、 {1 month 2 weeks 3 days 1 hour 1 second ago} 、{1979-02-26 18:30:00} )。これは以前の時点でのrefの値を指定します。この接尾辞は、ref名の直後にのみ使用でき、refには既存のログ( $GIT_DIR/logs/<ref> )が必要です。これは、特定の時点での ローカル refの状態を検索することに注意してください。たとえば、先週ローカルの master ブランチに何があったか、です。特定の時間に行われたコミットを確認する場合は、 --since と --until を参照してください。

refの後に接尾辞 @ が続き、数の指定が中括弧のペアで囲まれている場合(たとえば {1}, {15})、そのrefのn個前の値を指定します。たとえば master@{1} は master の直前の値であり、 master@{5} は master の5個前の値です。この接頭辞は、ref名の直後にのみ使用でき、refには既存のログ( $GIT_DIR/logs/<refname> )が必要です。

空のref部分で @ コンストラクトを使用して、現在のブランチのreflogエントリを取得できます。たとえば、あなたがブランチ blabla を使用している場合、 @{1} は blabla@{1} と同じ意味になります。

構成 @{-<n>} は、現在のブランチ/コミットの前にチェックアウトされた<n>番目のブランチ/コミットを意味します。

ブランチ B は、 リモート R (branch.<name>.remote で構成)で、ブランチ X (branch.<name>.merge で構成)の上に構築するようにセットアップできます。 B@{u} は、リモート R から取られたブランチ X のリモート追跡ブランチを参照し、 通常は refs/remotes/R/X にあります。

接尾辞 @\{push} は、 branchname がチェックアウトされているときに git push が実行された場合(またはブランチ名が指定されていない場合は現在の HEAD )、「プッシュ先」のブランチを報告します。 @\{upstream\} の場合と同様に、リモートのブランチに対応するリモート・トラッキング・ブランチを報告します。

$ git config push.default current
$ git config remote.pushdefault myfork
$ git switch -c mybranch origin/master

$ git rev-parse --symbolic-full-name @{upstream}
refs/remotes/origin/master

$ git rev-parse --symbolic-full-name @{push}
refs/remotes/myfork/mybranch

リビジョンパラメータの接尾辞 ^ は、そのコミットオブジェクトの最初の親を意味します。 ^<n> は <n> 番目の親を意味します(つまり、 <rev>^ は <rev>^1 と同じです)。特別ルールとして、 <rev>^0 はコミット自体を意味し、 <rev> がコミットオブジェクトを参照するタグオブジェクトのオブジェクト名である場合に使用されます。

リビジョンパラメータの接尾辞 ~ は、そのコミットオブジェクトの最初の親を意味します。リビジョンパラメータの接尾辞 ~<n> は、最初の親のみに続く、指定されたコミットオブジェクトの <n> 世代の祖先であるコミットオブジェクトを意味します。つまり、 <rev>~3 は <rev>^^^ と同じで、するってぇと <rev>^1^1^1 と同じということです。この形式については以下の図を参照してください。

接尾辞 ^ の後に中括弧のペアで囲まれたオブジェクトタイプ名が続くということは、タイプ <type> のオブジェクトが見つかるか、オブジェクトを逆参照できなくなるまで、 <rev> でオブジェクトを再帰的に逆参照する(この場合は、いろいろ一旦飲み込んでしまったのを吐きもどすような感じだぬ)ことを意味します。 たとえば、 <rev> がコミットっぽい場合、 <rev>^{commit} は対応するコミットオブジェクトを記述します。同様に、 <rev> がツリーっぽい場合、 <rev>^{tree} は対応するツリーオブジェクトを記述します。 <rev>^0 は <rev>^{commit} の省略形です。

接尾辞 ^ の後に空のブレースペアが続くということは、オブジェクトがタグである可能性があることを意味し、タグ以外のオブジェクトが見つかるまでタグを再帰的に逆参照します。

リビジョンパラメータの接尾辞 ^ と、それに続くスラッシュで始まるテキストを含む中括弧のペアは、以下の :/fix nasty bug 構文と同じですが、 ^ の前の <rev> から到達可能な一致する最も若いコミットを返す点が異なります。

コロンに続いてスラッシュそしてそれに続くテキストは、コミットメッセージが指定された正規表現と一致するコミットを示します。この名前は、HEADを含む任意のrefから到達可能な最も若い一致するコミットを返します。正規表現は、コミットメッセージの任意の部分に一致できます。文字列で始まるメッセージを照合するには、たとえば、 :/^foo とします。特別なシーケンス :/! はマッチングの修飾子用に予約されています。ます。 :/!-foo は一致の否定を実行し、 :/!!foo はリテラル ! 後に foo が続く文字列とマッチします。 :/! で始まるその他のシーケンスは今のところ予約されています。指定されたテキストによっては、シェルにより追加の引用符が必要になる場合があります。

接尾辞 : の後にパス(path)を続けると、コロンの前の部分によって名前が付けられたツリー風のオブジェクト内の、指定されたパスにあるブロブまたはツリーに名前が付けられます。 ./ または ../ で始まるパスは、現在の作業ディレクトリからの相対パスです。指定のパスは、作業ツリーのルートディレクトリからの相対パスに変換されます。これは、作業ツリーと同じツリー構造を持つコミットまたはツリーからブロブまたはツリーをアドレス指定するのに最も役立ちます。

コロンに、オプションでステージ番号(0〜3)とコロンが続き、それにパスが続くと、指定されたパスのインデックス内のブロブオブジェクトに名前を付けます。ステージ番号省略(およびそれに続くコロン)は、ステージ0エントリーを示します。マージ作業中、ステージ1は共通の祖先、ステージ2はターゲットブランチのバージョン(通常は現在のブランチ)、ステージ3はマージされるブランチのバージョンです。

<rev> から到達可能なコミット(つまり <rev> とその祖先)を含めます。

<rev> から到達可能なコミット(つまり <rev> とその祖先)を除外します。

<rev2> から到達可能なコミットを含めますが、 <rev1> から到達可能なコミットは除外します。 <rev1> または <rev2> のいずれかを省略すると、それらはそれぞれデフォルトで HEAD になります。

<rev1> または <rev2> のいずれかから到達可能なコミットを含めますが、両方から到達可能なコミットは除外します。 <rev1> または <rev2> のいずれかを省略すると、それらはそれぞれデフォルトで HEAD になります。

接尾辞 ^ の後にアットマーク(@)を付けることは、 <rev> のすべての親をリストすることと同じです(つまり、親から到達可能なものはすべて含まれますが、コミット自体は含まれません)。

接尾辞 ^ の後に感嘆符(!)を付けることは、コミット <rev> を指定し、そのすべての親に接頭辞 ^ を付けて、それら(およびその祖先)を除外することと同じです。

<rev>^<n>..<rev> と同等であり、 <n> が指定されていない場合は <n> = 1 です。