日本語 ▾ トピック ▾ 最新バージョン ▾ git-show-branch は 2.46.0 で最終更新されました

名前

git-show-branch - ブランチとそのコミットを表示する

概要

git show-branch [-a | --all] [-r | --remotes] [--topo-order | --date-order]
		[--current] [--color[=<when>] | --no-color] [--sparse]
		[--more=<n> | --list | --independent | --merge-base]
		[--no-name | --sha1-name] [--topics]
		[(<rev> | <glob>)…​]
git show-branch (-g | --reflog)[=<n>[,<base>]] [--list] [<ref>]

説明

<rev> または <glob> (または refs/heads および/または refs/tags の下のすべての参照) で指定されたコミットから始まるコミット履歴グラフを半視覚的に表示します。

一度に26個を超えるブランチとコミットを表示することはできません。

コマンドラインで <rev> または <glob> が指定されていない場合、showbranch.default の複数値設定項目を使用します。

オプション

<rev>

通常はブランチのヘッドまたはタグを指定する任意の拡張SHA-1表現 (gitrevisions[7] を参照)。

<glob>

refs/ の下のブランチ名またはタグ名に一致するグロブパターン。例えば、refs/heads/topic の下に多くのトピックブランチがある場合、topic/* を指定すると、それらすべてが表示されます。

-r
--remotes

リモート追跡ブランチを表示します。

-a
--all

リモート追跡ブランチとローカルブランチの両方を表示します。

--current

このオプションを使用すると、コマンドラインで指定されていない場合に、表示するリビジョンリストに現在のブランチが含まれます。

--topo-order

デフォルトでは、ブランチとそのコミットは逆時系列順に表示されます。このオプションを指定すると、トポロジー順 (つまり、子孫コミットが親コミットの前に表示される) に表示されます。

--date-order

このオプションは、親がその子のすべてより前に来ることはないという点で --topo-order と似ていますが、それ以外の場合、コミットはコミット日順に並べ替えられます。

--sparse

デフォルトでは、表示されている1つの先端からしか到達できないマージは出力から省略されます。このオプションを使用すると、それらも表示されます。

--more=<n>

通常、このコマンドは、すべてのブランチの共通の祖先であるコミットを表示すると出力を停止します。このフラグは、その共通コミットをさらに <n> 個表示するようにコマンドに指示します。<n> が負の場合、コミット履歴ツリーを表示せずに、指定された <ref> のみを表示します。

--list

--more=-1 の同義語

--merge-base

コミットリストを表示する代わりに、指定されたコミットの可能なマージベースを決定します。すべてのマージベースは、指定されたすべてのコミットに含まれます。これは、git-merge-base[1] が3つ以上のコミットを処理する方法とは異なります。

--independent

与えられた <ref> のうち、他の <ref> から到達できないものだけを表示します。

--no-name

各コミットの名前文字列を表示しません。

--sha1-name

ヘッドからそれらに到達するためのパス (例: "master" の祖父母を意味する "master~2") を使用してコミットに名前を付ける代わりに、それらのオブジェクト名の一意のプレフィックスで名前を付けます。

--topics

最初に与えられたブランチにないコミットのみを表示します。これにより、すでに開発のメインラインにあるコミットを隠すことで、トピックブランチの追跡に役立ちます。"git show-branch --topics master topic1 topic2" と指定すると、"git rev-list ^master topic1 topic2" で与えられたリビジョンが表示されます。

-g
--reflog[=<n>[,<base>]] [<ref>]

指定された参照の最新の <n> 個の参照ログエントリを表示します。<base> が指定されている場合、そのエントリから遡って <n> 個のエントリを表示します。<base> は、カウントまたは日付で指定できます。明示的な <ref> パラメータが指定されていない場合、デフォルトは現在のブランチ (またはそれがデタッチされている場合は HEAD) です。

--color[=<when>]

各コミットのステータス記号 (次のいずれか: * ! + -) を、それが属するブランチに対応する色で表示します。値は常に (デフォルト)、決して、または自動である必要があります。

--no-color

設定ファイルでデフォルトで色付き出力が指定されている場合でも、色付き出力をオフにします。--color=never と同じです。

--more、--list、--independent、および --merge-base オプションは相互に排他的であることに注意してください。

出力

N個の <ref> が与えられた場合、最初のN行はそれらのコミットメッセージからの1行の説明です。$GIT_DIR/HEAD が指すブランチヘッドにはアスタリスク * 文字が接頭辞として付き、他のヘッドには ! 文字が接頭辞として付きます。

これらN行に続き、各コミットの1行ログがN個インデントされて表示されます。コミットがI番目のブランチにある場合、I番目のインデント文字は + 記号を表示します。それ以外の場合はスペースを表示します。マージコミットは - 記号で示されます。各コミットは、そのコミットを命名するために拡張SHA-1として使用できる短い名前を表示します。

次の例は、「master」、「fixes」、「mhf」の3つのブランチを示しています。

$ git show-branch master fixes mhf
* [master] Add 'git show-branch'.
 ! [fixes] Introduce "reset type" flag to "git reset"
  ! [mhf] Allow "+remote:local" refspec to cause --force when fetching.
---
  + [mhf] Allow "+remote:local" refspec to cause --force when fetching.
  + [mhf~1] Use git-octopus when pulling more than one head.
 +  [fixes] Introduce "reset type" flag to "git reset"
  + [mhf~2] "git fetch --force".
  + [mhf~3] Use .git/remote/origin, not .git/branches/origin.
  + [mhf~4] Make "git pull" and "git fetch" default to origin
  + [mhf~5] Infamous 'octopus merge'
  + [mhf~6] Retire git-parse-remote.
  + [mhf~7] Multi-head fetch.
  + [mhf~8] Start adding the $GIT_DIR/remotes/ support.
*++ [master] Add 'git show-branch'.

これら3つのブランチはすべて、コミットメッセージが「Add 'git show-branch'」である共通のコミット [master] から分岐しました。「fixes」ブランチは1つのコミット「Introduce "reset type" flag to "git reset"」を追加します。「mhf」ブランチは他の多くのコミットを追加します。現在のブランチは「master」です。

例

プライマリブランチを refs/heads の直下に、トピックブランチをそのサブディレクトリに保持している場合、設定ファイルに次のように記述すると役立つ場合があります。

[showbranch]
	default = --topo-order
	default = heads/*

これにより、追加パラメータなしの git show-branch はプライマリブランチのみを表示します。さらに、トピックブランチにいる場合は、それも表示されます。

$ git show-branch --reflog="10,1 hour ago" --list master

1時間前の先端から遡って10個の参照ログエントリを表示します。--list なしでは、出力はこれらの先端が互いにトポロジー的にどのように関連しているかも示します。

設定

このセクションのこの行より下のすべての内容は、git-config[1] ドキュメントから選択的に含まれています。内容はそちらで見られるものと同じです。

showBranch.default

git-show-branch[1] のデフォルトのブランチセット。git-show-branch[1] を参照してください。

GIT

git[1]スイートの一部

scroll-to-top