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

Jusque là, nous avons suivi le ["TutorialCloneFr"] 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.

 $ cd my-hello
  $ hg log
  changeset:   3:80a9e007afc69cfb57870ddbcc1954631ed346d5
  tag:         tip
  user:        tnorth@localhost.localdomain
  date:        Tue Aug  2 16:42:17 2005
  summary:     Remplacement d'un texte en dur par une constante
  
  
  changeset:   2:585d49991504c67ce36bdc3ab198649755bca34e
  user:        tnorth@localhost.localdomain
  date:        Tue Aug  2 16:41:24 2005
  summary:     Ajout d'un define
  
  
  changeset:   1:17f90e6cbcf995772db378f8f7e1fef9dc96e394
  user:        tnorth@localhost.localdomain
  date:        Tue Aug  2 16:40:15 2005
  summary:     Ajout d'un retour à la ligne
  
  
  changeset:   0:26f06eb3cb703e66799aee792de5f75ecef1cb28
  user:        tnorth@localhost.localdomain
  date:        Tue Aug  2 16:38:31 2005
  summary:     import initial

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 quatre 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 votre zone horaire locale, sans se préoccuper du 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 -v log
  changeset:   0:26f06eb3cb703e66799aee792de5f75ecef1cb28
  manifest:    0:0961181060706e727afa6f1ec816514c096477fa
  user:        tnorth@localhost.localdomain
  date:        Tue Aug  2 16:38:31 2005
  files:       Makefile hello.c hello.h
  description:
  import initial
  ...

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 ["TutorialPremiersChangements"]