Français ▾ Topics ▾ Latest version ▾ git-show-branch last updated in 2.46.0

NOM

git-show-branch - Affiche les branches et leurs commits

SYNOPSIS

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

DESCRIPTION

Affiche de manière semi-visuelle le graphe des ancêtres des commits à partir des commits nommés par les <rév> ou <glob> (ou toutes les réfs sous refs/heads et/ou refs/tags).

Il ne peut pas montrer plus de 26 branches et commits à la fois.

Il utilise les éléments de configuration multi-valeurs de showbranch.default si aucun <rév> ou <glob> n’est donné sur la ligne de commande.

OPTIONS

<rév>

L’expression SHA-1 étendue (voir gitrevisions[7]) qui nomme généralement une tête de branche ou une étiquette.

<glob>

Un motif de glob qui correspond aux noms de branches ou d’étiquettes sous refs/. Par exemple, si vous avez beaucoup de branches de sujet sous refs/heads/sujet, donner ‘sujet/*’ les montrerait tous.

-r
--remotes

Afficher les branches de suivi à distance.

-a
--all

Montrer à la fois des branches de suivi à distance et des branches locales.

--current

Avec cette option, la commande inclut la branche actuelle dans la liste des révs à afficher lorsqu’elle n’est pas donnée sur la ligne de commande.

--topo-order

Par défaut, les branches et leurs commits sont affichés dans l’ordre chronologique inverse. Cette option les fait apparaître dans l’ordre topologique (c.-à-d. les commits descendants sont montrés devant leurs parents).

--date-order

Cette option est semblable à --topo-order dans le sens où aucun parent ne vient avant tous ses enfants, mais sinon les commits sont ordonnés selon leur date de commit.

--sparse

Par défaut, la sortie omet les fusions qui sont accessibles à partir d’un seul sommet affiché. Cette option les rend visibles.

--more=<n>

Habituellement, la commande arrête la sortie en montrant le commit qui est l’ancêtre commun de toutes les branches. Ce drapeau dit à la commande d’aller <n> commits communs au-delà. Lorsque <n> est négatif, n’affiche que les <réf>s données, sans montrer l’arbre des ancêtres.

--list

synonyme de --more=-1

--merge-base

Au lieu de montrer la liste de commit, déterminer les bases de fusion possibles pour les commits spécifiés. Toutes les bases de fusion seront contenues dans tous les commits spécifiés. Ceci est différent de la façon dont git-merge-base[1] gère le cas de trois commits ou plus.

--independent

Parmi les <réf>s données, n’afficher que celles qui ne peuvent être atteintes depuis aucune autre <réf>.

--no-name

Ne pas montrer de chaînes nominatives pour chaque commit.

--sha1-name

Au lieu de nommer les commits en utilisant le chemin pour les atteindre depuis les références (par exemple "master~2" pour signifier le grand-parent de "master"), les nommer avec le préfixe unique de leurs noms d’objets.

--topics

Affiche seulement les commits qui ne sont PAS sur la première branche donnée. Cela aide à suivre les branches de sujet en cachant tout commit qui est déjà dans la ligne principale du développement. Par exemple, "git show-branch --topics sujet1 sujet2", cela montrera les révisions données par "git rev-list ^ master sujet1 sujet2"

-g
--reflog[=<n>[,<base>]] [<réf>]

Affiche les <n> entrées de reflog les plus récentes pour la réf fournie. Si <base> est fourni, affiche <n> entrées antérieures à cette entrée. <base> peut être spécifié comme nombre ou date. Lorsqu’aucun paramètre explicite <réf> n’est donné, par défaut c’est la branche courante (ou HEAD si elle est détachée).

--color[=<quand>]

Colorier le signe de statut (parmi : * ! + -) de chaque commit correspondant à la branche dans laquelle il est. La valeur doit être « always » (c-à-d toujours) (valeur par défaut), « never » (c-à-d jamais) ou « auto ».

--no-color

Désactiver la sortie en couleur, même si le fichier de configuration donne par défaut la sortie en couleur. Identique à --color=never.

Notez que les options --more, --list, --independent et --merge-base sont mutuellement exclusives.

SORTIE

Si N <réf>s sont fournies, les N premières lignes sont la description en une ligne de leur message de commit. La tête de branche qui est pointée par $GIT_DIR/HEAD est préfixée avec un caractère astérisque * tandis que d’autres têtes sont préfixées avec un caractère !.

À la suite de ces N lignes, un journal en une ligne pour chaque commit est affiché, indenté N fois. Si un commit est sur la I-ème branche, le I-ème caractère d’indentation affiche un signe + ; sinon il affiche un espace. Les commits de fusion sont dénotés par un signe -. Chaque commit montre un nom court qui peut être utilisé comme un SHA-1 étendu pour nommer ce commit.

L’exemple suivant montre trois branches, "master", "fixes", et "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'.

Ces trois branches ont toutes divergé d’un commit commun, [master], dont le message de commit est « Add 'git show-branch' ». La branche "fixes" ajoute un commit « Introduce "reset type flag to "git reset" » drapeau à "réinitialisation correcte". La branche "mhf" ajoute beaucoup d’autres commits. La branche actuelle est "master".

EXEMPLES

Si vous gardez vos branches primaires immédiatement sous refs/heads, et les branches de sujet dans ses sous-répertoires, avoir les éléments suivants dans le fichier de configuration peut aider :

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

Avec cela, git show-branch sans paramètres supplémentaires ne montrerait que les branches primaires. En outre, si vous êtes sur votre branche thématique, elle est également montrée.

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

afficher 10 entrées de reflog en amont du sommet comme il y a 1 heure. Sans --list, la sortie montre également comment ces sommets sont topologiquement liés les uns aux autres.

CONFIGURATION

Tout ce qui se trouve en dessous de cette ligne dans cette section est inclus de manière sélective à partir de la documentation git-config[1]. Le contenu est le même que celui qui s’y trouve :

Warning

Missing fr/config/showbranch.adoc

See original version for this content.

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .