git-name-rev(1) Manual Page

ブランチ名は使用せず、コミットに名前を付けるためにタグのみを使用します

名前が特定のシェル・パターンに一致する ref のみを使用します。 パターンは、ブランチ名、タグ名、または完全修飾ref名、 のいずれかです。 複数回指定する場合は、 指定したシェル・パターンのいずれかに名前が一致する refs を使用します。 既に指定済のrefパターンをクリアするには --no-refs を使用します。

名前が特定のシェルパターンと一致するrefは使用しない。 パターンは、ブランチ名、タグ名、または完全修飾ref名のいずれかです。複数回指定された場合、指定されたパターンのいずれかに一致するrefは除外されます。 --refs と一緒に使用すると、refは少なくとも1つの --refs パターンに一致し、 --exclude パターンに一致しない場合にのみ一致として使用されます。 --no-exclude を使用して、除外パターンのリストをクリアします。

すべてのrefから到達可能なすべてのコミットを一覧表示します

標準入力に現れる16進40文字のSHA-1($hexとする)をすべて "$hex ($rev_name)" に置き換えます。 --name-only と一緒に使用する場合は、 "$rev_name" に置き換えて、 $hex を完全に省略します。 このオプションは Git の古いバージョンでは --stdin と呼ばれていました。

$ cat sample.txt

省略されたリビジョン 2ae0a9cb82 は置き換えられません。
置換後のフル・ネームは 2ae0a9cb8298185a94e5998086f380a355dd8907 で、
そのツリー・オブジェクトは 70d105cc79e63b81cfdcb08a15297c23e60b07ad です。

$ git name-rev --annotate-stdin <sample.txt

省略されたリビジョン 2ae0a9cb82 は置き換えられません。
置換後のフル・ネームは 2ae0a9cb8298185a94e5998086f380a355dd8907 (master) で、
そのツリー・オブジェクトは 70d105cc79e63b81cfdcb08a15297c23e60b07ad です。

$ git name-rev --name-only --annotate-stdin <sample.txt

省略されたリビジョン 2ae0a9cb82 は置き換えられません。
置換後のフル・ネームは master で、
そのツリー・オブジェクトは 70d105cc79e63b81cfdcb08a15297c23e60b07ad です。

SHA-1と名前の両方を印刷する代わりに、名前のみを印刷します。 --tags を指定すると、通常のタグプレフィックス "tags/" も名前から省略され、 git-describe の出力とより厳密に一致します。

参照が未定義の場合、 undefined を出力する代わりに、エラーコード != 0 で終了します。

一意を保つように省略されたコミットオブジェクトをフォールバックとして表示します。