Section courante

A propos

Section administrative du site

git log

Journal de bord
Git

Syntaxe

git log [options] [revision-range] [[--] path...]

Paramètres

Nom Description
revision-range Ce paramètre permet d'afficher uniquement les validations dans l'intervalle de révision spécifiée. Lorsqu'aucun revision-range n'est spécifié, la valeur par défaut est HEAD (c'est-à-dire tout l'historique menant à la validation actuelle). origin..HEAD spécifie tous les commits accessibles depuis le commit actuel (c'est-à-dire HEAD), mais pas depuis origin. Pour une liste complète des façons d'épeler revision-range.
[--] path... Ce paramètre permet d'afficher uniquement les commits suffisants pour expliquer comment les fichiers correspondant aux chemins spécifiés ont été créés. Les chemins devront peut-être être préfixés par -- pour les séparer des options ou de l'intervalle de révision, en cas de confusion.
--clear-decorations Ce paramètre permet d'effacer toutes les options --decorate-refs ou --decorate-refs-exclude précédentes et assouplit le filtre de décoration par défaut pour inclure toutes les références. Cette option est supposée si la valeur de configuration log.initialDecorationSet est définie sur all.
--decorate[=short|full|auto|no] Ce paramètre permet d'afficher les noms de référence de tous les commits affichés. Si short est spécifié, les préfixes du nom de référence refs/heads/, refs/tags/ et refs/remotes/ ne seront pas affichés. Si full est spécifié, le nom de référence complet (y compris le préfixe) sera affiché. Si auto est spécifié, alors si la sortie va vers un terminal, les noms de référence sont affichés comme si short était donné, sinon aucun nom de référence n'est affiché. L'option --decorate est un raccourci pour --decorate=short. Valeur par défaut de configuration de log.decorate si configurée, sinon, auto.
--decorate-refs=pattern
--decorate-refs-exclude=pattern
Ce paramètre permet, pour chaque référence candidate, de ne pas utilisez être utilisé pour la décoration si elle correspond à des modèles donnés à --decorate-refs-exclude ou si elle ne correspond à aucun des modèles donnés à --decorate-refs. L'option de configuration log.excludeDecoration permet d'exclure les références des décorations, mais un modèle --decorate-refs explicite remplacera une correspondance dans log.excludeDecoration. Si aucune de ces options ou paramètres de configuration n'est donné, alors les références sont utilisées comme décoration si elles correspondent à HEAD, refs/heads/, refs/remotes/, refs/stash/ ou refs/tags/.
--follow Ce paramètre permet de continuer à lister l'historique d'un fichier au-delà des renommages (ne fonctionne que pour un seul fichier).
--full-diff Ce paramètre permet d'afficher la différence complète pour les commits touchant les chemins spécifiés. Sans ce drapeau, git log -p path... affiche les commits touchant les chemins spécifiés et les différences sur les mêmes chemins spécifiés. Avec cela, la différence complète est affichée pour les commits touchant les chemins spécifiés ; cela signifie que ".?" limite uniquement les validations et ne limite pas les différences pour ces validations. Notez que cela affecte tous les types de sortie basés sur les différences, par exemple ceux produits par --stat,...
-Lstart,end:file
-L:funcname:file
Ce paramètre permet de suivre l'évolution de l'intervalle de lignes donnée par start,end ou par le nom de fonction regex funcname, dans le file. Vous ne pouvez donner aucun limiteur de spécification de chemin. Ceci est actuellement limité à une marche commençant à partir d'une seule révision, c'est-à-dire que vous ne pouvez donner que zéro ou un paramètre de révision positif, et start et end (ou funcname) doivent exister dans la révision de départ. Vous pouvez spécifier cette option plusieurs fois. Implique --patch. La sortie du correctif peut être supprimée en utilisant --no-patch, mais d'autres formats de différence (à savoir --raw, --numstat, --shortstat, --dirstat, --summary, --name-only, --name-status, --check) ne sont pas implémentés actuellement.
--log-size Ce paramètre permet d'inclure une ligne «log size number» dans la sortie de chaque validation, où number est la longueur du message de cette validation en octets. Destiné à accélérer les outils lisant les messages de journal de bord à partir de la sortie de git log en leur permettant d'allouer de l'espace à l'avance.
--no-decorate Ce paramètre permet d'afficher aucun noms de référence pour tous les commits affichés.
--[no-]mailmap Ce paramètre permet d'indiquer qu'il faut utiliser le fichier mailmap pour cartographier les noms et adresses de courriel des auteurs et des auteurs avec de vrais noms et adresses de courriel canoniques.
--source Ce paramètre permet d'afficher le nom de la référence donné sur la ligne de commande par laquelle chaque validation a été atteinte.
--[no-]use-mailmap Ce paramètre permet d'indiquer qu'il faut utiliser le fichier mailmap pour cartographier les noms et adresses de courriel des auteurs et des auteurs avec de vrais noms et adresses de courriel canoniques.

Description

Cette commande permet d'afficher le journal de bord des commit.

Exemple

L'exemple suivant permet de récupérer les informations de commits effectués dans votre référentiel :

git log --oneline --graph

vous obtiendrez un résultat ressemblant à ceci :

* 1b9c10c Version 2 commit (master, HEAD)
* 32559fb Version 1.0 commit
* 0a9ee48 added files
* ad6803f first commit


Dernière mise à jour : Mardi, le 5 Janvier 2021