English ▾ Themen ▾ Neueste Version ▾ git-show-branch zuletzt aktualisiert in 2.46.0

NAME

git-show-branch - Zeige Branches und ihre Commits

SYNOPSIS

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>]

BESCHREIBUNG

Zeigt den Commit-Abstammungsgraphen beginnend mit den mit <rev>s oder <glob>s benannten Commits (oder allen Refs unter refs/heads und/oder refs/tags) semi-visuell an.

Es können nicht mehr als 26 Branches und Commits gleichzeitig angezeigt werden.

Es werden die mehrwertigen Konfigurationsoptionen showbranch.default verwendet, wenn auf der Kommandozeile kein <rev> oder <glob> angegeben wird.

OPTIONEN

<rev>

Beliebiger erweiterter SHA-1-Ausdruck (siehe gitrevisions[7]), der typischerweise einen Branch-Head oder ein Tag benennt.

<glob>

Ein Glob-Muster, das Branch- oder Tag-Namen unter refs/ abgleicht. Wenn Sie beispielsweise viele Themen-Branches unter refs/heads/topic haben, zeigt die Angabe von topic/* alle davon an.

-r
--remotes

Zeigt die Remote-Tracking-Branches an.

-a
--all

Zeigt sowohl Remote-Tracking-Branches als auch lokale Branches an.

--current

Mit dieser Option schließt der Befehl den aktuellen Branch in die Liste der anzuzeigenden Revs ein, wenn dieser nicht auf der Kommandozeile angegeben wurde.

--topo-order

Standardmäßig werden die Branches und ihre Commits in umgekehrter chronologischer Reihenfolge angezeigt. Diese Option bewirkt, dass sie in topologischer Reihenfolge erscheinen (d.h. Nachfolger-Commits werden vor ihren Eltern angezeigt).

--date-order

Diese Option ist ähnlich wie --topo-order in dem Sinne, dass kein Elternteil vor all seinen Kindern kommt, aber ansonsten werden Commits nach ihrem Commit-Datum sortiert.

--sparse

Standardmäßig lässt die Ausgabe Merges aus, die nur von einem der angezeigten Tips erreichbar sind. Diese Option macht sie sichtbar.

--more=<n>

Normalerweise stoppt der Befehl die Ausgabe, nachdem der Commit angezeigt wurde, der der gemeinsame Vorfahre aller Branches ist. Dieses Flag weist den Befehl an, <n> weitere gemeinsame Commits über diesen hinaus anzuzeigen. Wenn <n> negativ ist, werden nur die angegebenen <ref>s angezeigt, ohne den Commit-Abstammungsbaum zu zeigen.

--list

Synonym für --more=-1

--merge-base

Anstatt die Commit-Liste anzuzeigen, werden mögliche Merge-Basen für die angegebenen Commits ermittelt. Alle Merge-Basen sind in allen angegebenen Commits enthalten. Dies unterscheidet sich von der Art und Weise, wie git-merge-base[1] den Fall von drei oder mehr Commits behandelt.

--independent

Unter den angegebenen <ref>s werden nur diejenigen angezeigt, die von keinem anderen <ref> erreicht werden können.

--no-name

Zeigt keine Namenszeichenfolgen für jeden Commit an.

--sha1-name

Anstatt die Commits anhand des Pfades zu ihnen von den Heads aus zu benennen (z.B. "master~2" für den Großvater von "master"), werden sie mit dem eindeutigen Präfix ihrer Objekt-Namen benannt.

--topics

Zeigt nur Commits, die NICHT auf dem ersten angegebenen Branch liegen. Dies hilft beim Verfolgen von Themen-Branches, indem Commits ausgeblendet werden, die sich bereits in der Hauptentwicklungslinie befinden. Wenn "git show-branch --topics master topic1 topic2" angegeben wird, werden die von "git rev-list ^master topic1 topic2" angegebenen Revisionen angezeigt.

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

Zeigt die <n> neuesten Reflog-Einträge für den angegebenen Ref an. Wenn <base> angegeben wird, werden <n> Einträge zurück von diesem Eintrag angezeigt. <base> kann als Zählung oder Datum angegeben werden. Wenn kein expliziter <ref>-Parameter angegeben wird, wird standardmäßig der aktuelle Branch (oder HEAD, wenn er abgetrennt ist) verwendet.

--color[=<when>]

Färbt das Statuszeichen (eines davon: * ! + -) jedes Commits entsprechend dem Branch, zu dem er gehört. Der Wert muss immer (Standard), niemals oder auto sein.

--no-color

Schaltet die farbige Ausgabe aus, auch wenn die Konfigurationsdatei standardmäßig die farbige Ausgabe vorgibt. Das Gleiche wie --color=never.

Beachten Sie, dass die Optionen --more, --list, --independent und --merge-base sich gegenseitig ausschließen.

AUSGABE

Bei N angegebenen <ref>s sind die ersten N Zeilen die einzeilige Beschreibung aus ihrer Commit-Nachricht. Der Branch-Head, auf den $GIT_DIR/HEAD zeigt, wird mit einem Sternchen *-Zeichen vorangestellt, während andere Heads mit einem !-Zeichen vorangestellt werden.

Nach diesen N Zeilen wird ein einzeiliger Log für jeden Commit angezeigt, der um N Stellen eingerückt ist. Wenn ein Commit auf dem I-ten Branch liegt, zeigt das I-te Einrückungszeichen ein +-Zeichen; ansonsten zeigt es ein Leerzeichen. Merge-Commits werden durch ein --Zeichen gekennzeichnet. Jeder Commit zeigt einen Kurznamen, der als erweiterter SHA-1 zur Benennung dieses Commits verwendet werden kann.

Das folgende Beispiel zeigt drei Branches: "master", "fixes" und "mhf"

$ 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'.

Diese drei Branches sind alle von einem gemeinsamen Commit, [master], abgezweigt, dessen Commit-Nachricht "Add 'git show-branch'" lautet. Der "fixes"-Branch fügt einen Commit hinzu: "Introduce "reset type" flag to "git reset"". Der "mhf"-Branch fügt viele weitere Commits hinzu. Der aktuelle Branch ist "master".

BEISPIELE

Wenn Sie Ihre primären Branches unmittelbar unter refs/heads und Themen-Branches in Unterverzeichnissen davon aufbewahren, kann die folgende Konfiguration im Konfigurationsfile hilfreich sein

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

Damit würde git show-branch ohne zusätzliche Parameter nur die primären Branches anzeigen. Wenn Sie sich zufällig auf Ihrem Themen-Branch befinden, wird dieser ebenfalls angezeigt.

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

zeigt 10 Reflog-Einträge rückwärts vom Tip vor 1 Stunde an. Ohne --list zeigt die Ausgabe auch, wie diese Tips topologisch miteinander verbunden sind.

KONFIGURATION

Alles unterhalb dieser Zeile in diesem Abschnitt wird selektiv aus der git-config[1]-Dokumentation übernommen. Der Inhalt ist derselbe wie dort zu finden.

showBranch.default

Die Standardmenge an Branches für git-show-branch[1]. Siehe git-show-branch[1].

GIT

Teil der git[1] Suite