Tutorial - Examiner l'historique du dépôt

Jusque là, nous avons suivi le FrenchTutorialClone pour cloner un dépôt; notre copie locale s'appelle my-hello.

Regardons l'historique de ce dépôt. Pour cela, nous utilisons la commande log. Elle affiche le résumé de chaque événement qui s'est produit dans le dépôt, allant du premier au plus récent.

Note: si l'historique grandit et que nous ne désirons voir que les nouveaux changement, il peut être intéressant d'utiliser hg log | head [-<nombre de lignes>]

$ cd my-hello
$ hg log
changeset:   1:82e55d328c8c
tag:         tip
user:        mpm@selenic.com
date:        Fri Aug 26 01:21:28 2005 -0700
summary:     Create a makefile

changeset:   0:0a04b987be5a
user:        mpm@selenic.com
date:        Fri Aug 26 01:20:50 2005 -0700
summary:     Create a standard "hello, world" program

Ces lignes de sortie nécessitent quelques informations.

• Chaque paragraphe décrit un ChangeSet particulier. Un ChangeSet est une modification de un ou plusieurs fichiers, groupés en une unité logique.

• Dans le cas ci-dessus, nous pouvons voir que l'historique du dépôt consiste en deux ChangeSets.

• changeset identifie un ChangeSet.

  • Le premier nombre avant les deux points est le numéro de révision; c'est une manière rapide d'identifier un ChangeSet. Il est valide uniquement dans ce dépôt.

  • La longue chaîne hexadécimale après les deux points est le ChangeSetID; il identifie de manière unique le ChangeSet, et est le même dans tous les dépôts qui contiennent ce ChangeSet. Si vous discutez avec quelqu'un d'un ChangeSet, utilisez le ChangeSetID, pas le numéro de révision.

• tag est une étiquette, nom arbitraire symbolique pour un ChangeSet.

  • Vous pouvez assigner une ou plusieurs étiquettes à n'importe quel ChangeSet. Naturellement, certains ChangeSets n'auront pas étiquette associée, donc la ligne tag ne sera pas toujours présente.

  • L'étiquette spéciale tip identifie toujours le "Tip", qui est le plus récent ChangeSet dans le dépôt. Si vous créez un autre ChangeSet (et nous le ferons bientôt), il deviendra le Tip.

• user identifie la personne qui a créé le ChangeSet. C'est une chaîne de forme libre, qui contient généralement une adresse e-mail, et parfois le nom de la personne également.

• date définit la date à laquelle le ChangeSet a été créé. Ces dates sont données dans la zone horaire locale correspondant au fuseau horaire du créateur du ChangeSet.

• summary donne la première ligne de description du ChangeSet. Elle a été entrée par le créateur du ChangeSet en question au moment ou il l'a créé, pour s'aider et aider les autres à comprendre le but du ChangeSet.

Nous pouvons avoir un historique plus détaillé en demandant une sortie verbeuse :

$ hg log -v
changeset:   1:82e55d328c8ca4ee16520036c0aaace03a5beb65
tag:         tip
user:        mpm@selenic.com
date:        Fri Aug 26 01:21:28 2005 -0700
files:       Makefile
description:
Create a makefile

...

La sortie verbeuse contient quelques champs de plus que la vue par défaut.

• revision est un champ que vous pouvez ignorer.

• files liste les fichiers du changeset.

• description contient la description complète et multiligne du ChangeSet, au lieu de simplement la première ligne.

Maintenant nous avons une idée plus claire de ce qui se passe, plongeons-nous dedans et faisons des modifications ! En avant, au FrenchTutorialFirstChange

CategoryFrench