Si un ou plusieurs <motif> sont donnés, les seules réfs affichées sont celles qui correspondent à au moins un motif, soit à l’aide de fnmatch(3), soit littéralement, et dans ce dernier cas avec une correspondant complète ou depuis le début jusqu’à une barre oblique.

Lire la liste des motifs depuis l’entrée standard au lieu d’une liste d’arguments.

S’arrêter après avoir montré <nombre> réfs.

Trier sur le nom de champ _ <clé>_. Préfixez avec - pour trier dans ordre descendant de la valeur. Lorsque ce n’est pas précisé, refname est utilisé . Vous pouvez utiliser l’option --sort=<clé> plusieurs fois, auquel cas la dernière clé devient la clé primaire.

Une chaîne qui interpole %(fieldname) d’une réf affichée et l’objet qu’elle pointe. En outre, la chaîne littérale %% s’affiche comme % et %xx - où xx sont des chiffres hexadécimaux - s’affiche comme le caractère avec code hexadécimal xx. Par exemple, %00 s’interpole à \0 (NUL), %09 à \t (TAB), et %0a à \n (LF).

Respecter toutes les couleurs spécifiées dans l’option --format. Le champ <quand> doit être un des valeurs always, never, ou auto (si <quand> est absent, se comporte comme si always était donné).

Si elles sont données, les chaînes qui remplacent les variables`%(<nom-de-champ)` sont citées comme des chaînes littérales adaptées au langage hôte spécifié. Ceci est destiné à produire un script qui peut être directement "éval"ué.

Afficher seulement les références pointant sur l’objet.

Ne lister que les références dont les sommets sont accessibles à partir du commit spécifié (HEAD si non spécifié).

Ne lister que les réfs dont les sommets ne sont pas accessibles à partir de <objet> (HEAD si non spécifié).

Ne répertorier que les références qui contiennent <objet> (HEAD si non spécifié).

Ne répertorier que les références qui ne contiennent pas <objet> (HEAD si non spécifié).

Le tri et le filtrage sont non-sensibles à la casse.

Ne pas afficher de nouvelle ligne après les refs formatés lorsque le format se développe en chaîne vide.

Si une ou plusieurs options --exclude sont données, seuls les réfs qui ne correspondent à aucun paramètre <motif-exclus> sont affichés. La correspondance est faite en utilisant les mêmes règles que <motif> ci-dessus.

Lister les réfs racine (HEAD et les pseudo-réfs) en dehors des réfs régulières.

Permet de paginer la sortie en sautant des références jusqu’à et y compris le marqueur spécifié. Lors de la pagination, il convient de noter que les références peuvent être supprimées, modifiées ou ajoutées entre les invocations. La sortie ne produira que les références qui suivent le marqueur lexicographiquement. La sortie commence par la première référence qui viendrait après le marqueur par ordre alphabétique. Ne peut pas être utilisé avec les options --sort=<clé> ou --stdin, ou avec le ou les argument(s) <motif> pour limiter les réfs.

Le nom de la référence (la partie après $GIT_DIR/). Pour un nom court non ambigu de la référence, ajouter :short. L’option core.warnAmbiguousRefs est utilisée pour sélectionner le mode d’abréviation strict. Si lstrip=<n> (rstrip=<n>) est ajouté, supprimer <n> composants de chemin séparés par des barres obliques depuis le début (la fin) du nom de référence (p. ex. %(refname:lstrip=2) transforme refs/tags/foo en foo et %(refname:rstrip=2) transforme refs/tags/foo en refs). Si <n> est un nombre négatif, supprimer autant de composants de chemin que nécessaire depuis l’extrémité spécifiée pour laisser -<n> composants de chemin (p. ex. %(refname:lstrip=-2) transforme refs/tags/foo en tags/foo et %(refname:rstrip=-1) transforme refs/tags/foo en refs). Quand la référence n’a pas assez de composants, le résultat devient une chaîne vide si on supprime avec un <n> positif, ou le nom de référence complet si on supprime avec un <N> négatif. Aucun des deux n’est une erreur.

Le type de l’objet (blob, tree, commit, tag).

La taille de l’objet (la même que rapportée par git cat-file -s). Ajoutez :disk pour obtenir la taille en octets, que l’objet occupe sur le disque. Voir la note sur les tailles sur disque dans la section MISES EN GARDES ci-dessous.

Le nom de l’objet (alias SHA-1). Pour une abréviation non ambiguë du nom d’objet, ajouter :short. Pour une abréviation du nom d’objet avec la longueur souhaitée, ajouter :short=<longueur>, où la longueur minimale est MINIMUM_ABBREV. La longueur peut être dépassée pour garantir des noms d’objets uniques.

Cela se développe en le nom d’objet de la base delta pour l’objet donné, s’il est stocké comme un delta. Sinon, cela se développe en le nom d’objet nul (tous les zéros).

Le nom d’une référence locale qui peut être considérée comme « amont » par rapport à la référence affichée. Respecte :short, :lstrip et :rstrip de la même façon que refname ci-dessus. Respecte également :track pour afficher « [ahead N, behind M] » et :trackshort pour afficher la version concise : « > » (en avance), « < » (en retard), « <> » (en avance et en retard), ou « = » (synchronisé). :track affiche aussi « [gone] » chaque fois qu’une référence amont inconnue est rencontrée. Ajouter :track,nobracket pour afficher les informations de suivi sans crochets (c’est-à-dire « ahead N, behind M »).

Le nom d’une référence locale qui représente l’emplacement @{push} pour la référence affichée. Respecte les options :short, :lstrip, :rstrip, :track, :trackshort, :remotename et :remoteref comme le fait upstream. Produit une chaîne vide si aucune référence @{push} n’est configurée.

* si HEAD correspond à la référence courante (la branche extraite), ' ' sinon.

Changer la couleur de sortie. Suivi de :<nom-de-couleur>, où les noms de couleur sont décrits sous Valeurs dans la section « FICHIER DE CONFIGURATION » de git-config[1]. Par exemple, %(color:bold red).

Aligner à gauche, au milieu ou à droite le contenu entre %(align:...) et %(end). L'« align: » est suivi de width=<largeur> et position=<position> dans n’importe quel ordre séparés par une virgule, où <position> est soit left, right ou middle, la valeur par défaut étant left et <largeur> est la longueur totale du contenu avec l’alignement. Par souci de concision, les préfixes « width= » et/ou « position= » peuvent être omis, et les simples <largeur> et <position> utilisés à la place. Par exemple, %(align:<largeur>,<position>). Si la longueur du contenu est supérieure à la largeur, aucun alignement n’est effectué. Si utilisé avec --quote, tout ce qui se trouve entre %(align:...) et %(end) est entre guillemets, mais si imbriqué, seul le niveau le plus élevé effectue la mise entre guillemets.

Utilisé comme %(if)...%(then)...%(end) ou %(if)...%(then)...%(else)...%(end). S’il y a un atome avec une valeur ou un littéral de chaîne après le %(if), tout ce qui suit le %(then) est affiché, sinon si l’atome %(else) est utilisé, tout ce qui suit %(else) est affiché. On ignore les espaces lors de l’évaluation de la chaîne avant %(then), ce qui est utile quand on utilise l’atome %(HEAD) qui affiche soit « * » soit « » et qu’on veut appliquer la condition if uniquement sur la référence HEAD. Ajouter « :equals=<chaîne> » ou « :notequals=<chaîne> » pour comparer la valeur entre les atomes %(if:...) et %(then) avec la chaîne donnée.

La référence à laquelle la référence symbolique donnée fait référence. Si ce n’est pas une référence symbolique, rien n’est affiché. Respecte les options :short, :lstrip et :rstrip de la même façon que refname ci-dessus.

La signature GPG d’un commit.

Afficher

Le signataire de la signature GPG d’un commit.

La clé de la signature GPG d’un commit.

L’empreinte de la signature GPG d’un commit.

L’empreinte de la clé principale de la signature GPG d’un commit.

Le niveau de confiance de la signature GPG d’un commit. Les sorties possibles sont ultimate, fully, marginal, never et undefined.

Le chemin absolu vers l’arbre de travail dans lequel la référence est extraite, si elle est extraite dans un arbre de travail lié. Chaîne vide sinon.

Deux entiers, séparés par un espace, indiquant respectivement le nombre de commits en avance et en retard, lors de la comparaison de la référence de sortie avec le <validesque> spécifié dans le format.

Dans au plus une ligne, (<validesque>) apparaîtra pour indiquer la référence qui est très probablement la référence utilisée comme point de départ de la branche qui a produit <validesque>. Ce choix est fait par heuristique : choisir la référence qui minimise le nombre de commits dans l’historique du premier parent de <validesque> et pas dans l’historique du premier parent de la référence.

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

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

Un nom lisible par l’homme, comme git-describe[1] ; chaîne vide pour les commits non descriptibles. La chaîne describe peut être suivie de deux points et une ou plusieurs options séparées par des virgules.

La taille des données brutes de l’objet.

La taille en octets du message de validation ou d’étiquette.

Le premier paragraphe du message, qui est typiquement une seule ligne, est pris comme le « sujet » du commit ou du message d’étiquette. Au lieu de contents:subject, le champ subject peut aussi être utilisé pour obtenir les mêmes résultats. :sanitize peut être ajouté à subject pour une ligne de sujet adaptée à un nom de fichier.

Le reste du message de validation ou d’étiquette qui suit le « sujet ».

La signature GPG optionnelle de l’étiquette.

les <n> premières lignes du message.