La principale commande permettant de consulter l'historique d'un projet git est la commande git log. Quelques options largement utilisées:

Pour limiter la sortie aux n derniers commit insérer -n:

$ git log --oneline --stat -2

Ici les titres des deux derniers commits seront affichés avec les statistiques des fichiers modifiés.

Il est également possible de limiter l'historique retourné sur des critères temporels. Pour n'afficher que les commits émis depuis 2 semaines:

$ git log --since=2.weeks

On peut également choisir de n'afficher les commits d'un auteur en spécifiant le filtre --author

Si l'on souhaite afficher les commits ayant introduit des modifications contenant la chaîne de caractères “exemple”:

git log -Sexemple

La commande ci-dessus retournera les commits comportant des patchs ayant introduits ou retirés la chaîne “exemple”.

On peut placer en dernière option de git log est un chemin (fichier ou répertoire). Cette option est précédée d'un séparateur double tirets **--**:

$ git log --oneline --name-status -- lib/

La commande ci-dessus n'affichera que les commits ayant introduits des changements sur le dossier lib

Ci dessous un alias à ajouter dans le fichier de configuration ~/.gitconfig pour modifier la mise en forme de l'historique par défaut:

[alias]
    lg = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' --all

Cette mise en forme présente un graph avec l'ensemble des branches et affiche les références.

ToDo

• Pro Git, seconde édition, Scott Chacon et Ben Straub
• http://stackoverflow.com/questions/1057564/pretty-git-branch-graphs