git-for-each-ref(1) Manual Page

1つ以上のパターン(<pattern>)が指定されている場合、 少なくとも1つのパターンに一致する参照のみが表示されます。 fnmatch(3) を使用するか、 文字通り(lietrally)に書くかです。 文字通りに書いた場合、 完全に一致するか、 先頭からスラッシュ(/)まで一致するかです。

パターンのリストは引数リストからではなく標準入力から読み取られます。

<count> 個の参照を表示して停止(stop)します。

並べ替えるフィールド名を <key> とします。 プレフィックス - を使用すると、 値の降順で並べ替えます。 並べ替えるフィールド名を指定しない場合 refname が使用されます。 --sort=<key> オプションは複数回使用できます。 その場合、 最後のキーが主キー(primary key)になります。

表示されている参照とそれが指すオブジェクトを %(フィールド名) によって差し込みする書式文字列。 更に、 リテラル文字列の %% は % とレンダリングされ、 %xx は16進数 xx の値のキャラクター・コードをレンダリングします。 たとえば %00 は \0(NUL)、 %09 は \t(TAB)、 %0a は \n(LF)を差し込みます。

--format オプションで指定された色を尊重します。 <when> フィールドは always または never または auto のいずれかでなければなりません(<when> の指定が無い場合は、 always が指定されたかのように動作します)。

指定した場合、 %(fieldname) プレースホルダーを置き換える文字列は、指定のホストプログラム言語に適した文字列リテラルとしてクォートします。これは、直接「評価」(eval)できるスクリプトレットを作成することを目的としています。

指定のオブジェクトを指す参照のみをリストします。

指定のコミット(指定されていない場合は HEAD)から先端に到達できる参照のみをリストします。

<object> (指定されていない場合は HEAD)から先端に到達でき無い参照のみをリストします。

<object> (指定されていない場合は HEAD)を含む参照のみをリストします。

<object> (指定されていない場合は HEAD)を含ま無い参照のみをリストします。

参照の並べ替え(sort)とフィルタリングでは英大文字小文字を区別しません。

フォーマットが空の文字列に展開されるフォーマット済み参照の後に改行を出力しないでください。

1つ以上の --exclude オプションが与えられている場合、 与えられた <excluded-pattern> パラメーター達とマッチし無い参照のみが表示されます。 マッチングは、 上記 の <pattern> と同じルールを使用して行われます。

通常の参照以外のルート参照(root refs)(HEAD と疑似参照)をリストします。

ページ単位での出力(ページネーション;pagination)を可能にし、 指定されたマーカー(<marker>)(マーカー自身も含めて)までの参照をスキップします。 参照はページ単位での出力中に削除または変更または追加される可能性があることに注意してください。 出力には、 マーカーの辞書順(lexicographically)で後に続く参照のみが含まれます。 出力は、 マーカーよりアルファベット順(alphabetically)で次に来る最初の参照から始まります。 --sort=<key> オプションや --stdin オプション、 または参照を制限するための <pattern> 引数と併用することはできません。

参照の名前( $GIT_DIR/ の後の部分)。 参照のあいまいで無い短い名前の場合は、 :short を追加します。 オプション core.warnAmbiguousRefs は、 厳密な省略形モードを選択するために使用されます。 lstrip=<n> (rstrip=<n>) が追加された場合、 refname の前(後ろ) からスラッシュ(/)で区切られたパスの部分を <n> 個削除します(例: %(refname:lstrip=2) は refs/tags/foo を foo に変換し、 %(refname:rstrip=2) は refs/tags/foo を refs に変換します)。 <n> が負数の場合、 指定された側から必要な数のパス・コンポーネントを削除して、 -<N> 個のパス・コンポーネントを残します(たとえば、 %(refname:lstrip=-2) は refs/tags/foo を tags/foo に変換し、 %(refname:rstrip=-1) は refs/tags/foo を refs に変換します)。 参照に十分な数のパス・コンポーネントがない場合、 正数の <n> で縮める(strip)と結果は空の文字列になり、 負数の <n> で縮める(strip)と完全な参照名(full refname)になります。 どちらもエラーではありません。

オブジェクトのタイプ(blob, tree, commit, tag)。

オブジェクトのサイズ(git cat-file -s がレポートするものと同じです)。 :disk を追加して、 オブジェクトがディスク上で占めるサイズをバイト単位で取得できます。 以下の「CAVEATS」(注意事項)セクションのディスク上のサイズに関する注記を参照してください。

オブジェクト名(別名SHA-1)。 オブジェクト名のあいまいで無い省略形については、 :short を追加してください。 目的の長さのオブジェクト名の省略形については、 :short=<length> を追加します。 ここで、 最小の長さは MINIMUM_ABBREV です。 それを一意のオブジェクト名にするために指定の長さを超える場合があります。

デルタとして保存されている場合、これは指定されたオブジェクトのデルタベースのオブジェクト名に展開されます。それ以外の場合は、ヌルオブジェクト名(すべてゼロ)に展開されます。

表示された参照から「上流」(upstream)と見なすことができるローカル参照の名前。 上記の refname と同じように、 :short や :lstrip や :rstrip を尊重します。さらに、 :track は [ahead N, behind M] を表示し、 :trackshort は > (ahead) または < (behind) または "<>" (ahead and behind) または "=" (in sync) という簡潔なバージョンを表示します。 :track は不明なアップストリーム参照が検出されるたびに [gone] も出力します。 :track,nobracket を追加すると角かっこ([ と ] )無しで追跡情報を表示します（つまり、 ahead N, behind M )。

表示された参照の @{push} の場所を表すローカル参照の名前。 upstream と同様に :short, :lstrip, :rstrip, :track, :trackshort, :remotename, :remoteref オプションを尊重します。 @{push} 参照が設定されていない場合、 空の文字列を生成します。

HEAD が現在の参照(チェックアウトされたブランチ)と一致する場合は * 、 それ以外の場合は ' ' 。

出力色を変更します。 その後に :<colorname> が続きます。色の名前は、 git-config(1) の「CONFIGURATION FILE」セクションの「Values」で説明されています。 たとえば、 %(color:bold red) です。

コンテンツを %(align:...) から %(end) の間で左揃え、中央揃え、または右揃えにします。 align: の後には、 width=<width> と position=<position> がコンマ(,)で区切られた任意の順序で続きます。 ここで、 <position> は left または right または middle のいずれかで、 <position> の デフォルトは left で、 <width> のデフォルトは配置されたコンテンツの全長です。 簡潔にするために、 width= および/または position= プレフィックスを省略して、 代わりに裸の <width> および <position> を使用することができます。 たとえば、 %(align:<width>,<position>) です。 コンテンツの長さが <width> よりも大きい場合、 位置合わせは実行されません。 --quote とともに使用すると、 %(align:...) 〜 %(end) の間のすべてがクォートされまれますが、 ネストされている場合は、 最上位レベルのみがクォートされます。

%(if)…%(then)…%(end) または %(if)…%(then)…%(else)…%(end) として使用されます。 %(if) の後に値または文字列リテラルを持つアトムがある場合は、 %(then) の後のすべてが出力されます。 そうでない場合、 %(else) アトムが使用されている場合は、 %(else) の後のすべてが出力されます。 %(then) の前の文字列を評価するときは空白を無視します。 これは、 "*" または " " のいずれかを出力する %(HEAD) アトムを使用し、 HEAD 参照にのみ if 条件を適用する場合に役立ちます。 ":equals=<string>" または ":notequals=<string>" を追加して、 %(if:...) アトムから %(then) アトムの間の値を指定の文字列と比較します。 (訳注:つまり、 %(if) から %(then) の間が条件である)

指定のンボリック参照が参照する参照。 シンボリック参照でない場合、 何も出力されません。 上記の refname と同一の方法で、 :short と :lstrip と :rstrip オプションを尊重します。

コミットのGPG署名。

コミットのGPG署名のグレードを表示:

コミットのGPG署名の署名者。

コミットのGPG署名のキー。

コミットのGPG署名のフィンガープリント。

コミットの GPG 署名の主キー(primary key)のフィンガープリント。

コミットの GPG 署名の信頼レベル(trust level)。 可能な出力は、 ultimate, fully, marginal, never, undefined です。

リンクされたワークツリー(linked worktree)でチェックアウトされている場合、 参照がチェックアウトされているワークツリーへの絶対パス。 それ以外の場合は空文字列です。

空白で区切られた2つの整数が、 書式内で指定されたコミットっぽい何か(<commit-ish>)と出力の参照を比較したときの、 それぞれ前方と後方のコミット数をあらわします。

指定の <commit-ish> を生成したブランチの開始点として最も可能性の高い参照であると選択した1行には (<commit-ish>) と表記されます。 この選択は、 ヒューリスティックを使用して行われます: つまり、 <commit-ish> の最初の親の履歴の中でコミットの数を最小化する参照を選択します。

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
        *--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

git-describe(1) のような人間が読み取り可能な名前。 describe 出来ないコミットの場合は空文字列。 describe 文字列の後には、 コロン(:)と1つ以上のコンマ(,)区切りオプション達が続く場合があります。

オブジェクトの生データサイズ。

コミットメッセージまたはタグメッセージのバイト単位のサイズ。

メッセージの最初の段落(通常は1行)は、コミットまたはタグメッセージの「件名」(subject)と見なされます。 contents:subject の代わりに、フィールド subject を使用して同じ結果を取得することもできます。 subject に追加できる :sanitize は、件名行をファイル名に適した形にします。

コミットメッセージまたはタグメッセージの「件名」に続く残りの部分。

タグのオプションのGPG署名。

メッセージの最初の <n> 行。