|
Size: 3984
Comment:
|
← Revision 20 as of 2012-11-06 23:57:11 ⇥
Size: 7348
Comment: remove excessive linking to changeset
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = Tutorial - Examiner l'historique du dépôt = = | #language fr ## page was renamed from TutorialHistorique ## 2009-08-06 Frédéric Bouquet (youshe) <youshe.jaalon@gmail.com> : Mise à jour de la version Française |
| Line 3: | Line 5: |
| Jusque là, nous avons suivi le ["TutorialCloneFr"] pour cloner un dépôt; notre copie locale s'appelle my-hello. | Ce document est une traduction du document original [[TutorialInstall]] |
| Line 5: | Line 7: |
| 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. | == Tutorial - Examiner l'historique du dépôt == ''(Cette page est la partie 3 sur 9 de la série [[FrenchTutorial]]. La partie précédente est [[FrenchTutorialClone]], la partie suivante est [[FrenchTutorialFirstChange]])'' A ce point, nous avons suivi [[FrenchTutorialClone]] pour cloner un dépôt. Notre copie locale est appelée {{{mon-hello}}}. Regardons maintenant l'historique ce ce [[Repository|dépôt]]. Pour ce faire, nous utilisons la commande {{{log}}}. Ceci affiche un résumé de chaque évènement qui ont eu lieu dans le dépôt, en remontant dans le temps à partir du plus récent. |
| Line 8: | Line 16: |
| $ 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 |
$ 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 |
| Line 34: | Line 28: |
| Ces lignes de sortie nécessitent quelques informations. | |
| Line 36: | Line 29: |
| * 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. |
Ces quelques lignes de sortie ont besoin de quelques explications : |
| Line 48: | Line 31: |
| Nous pouvons avoir un historique plus détaillé en demandant une sortie verbeuse : | * Chaque paragraphe décrit un [[ChangeSet|changeset]] particulier. Un changeset est une modification de un ou plusieurs fichiers, groupés en une unité logique. * Dans notre 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 [[RevisionNumber|numéro de révision]]. Il s'agit d'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]], et non le numéro de révision. * {{{tag}}} est une [[Tag|étiquette]], nom arbitraire symbolique pour un changeset. * Vous pouvez assigner une ou plusieurs étiquettes à n'importe quel changeset. Naturellement, peu de changesets auront une étiquette associée, donc la ligne tag ne sera pas toujours présente. * L'étiquette spéciale {{{tip}}} identifie toujours le [[Tip|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), l'étiquette {{{tip}}} sera retirée du plus récent changeset et sera ajouté au nouveau changeset. * {{{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. * {{{parent}}} définit le changeset parent. Dans certains cas, il en existe plus d'un, ce qui arrive lorsque vous [[Merge|fusionnez (merge)]] les changements depuis différents dépôts. * La plupart du temps il n'y a qu'un seul changeset parent, qui est le changeset juste plus vieux que celui ci. C'est le cas pour notre exemple juste au dessus. Nous pouvons avoir un historique plus détaillé en demandant une sortie verbeuse à l'aide de l'option {{{-v}}}, ou l'option globale {{{--debug}}} pour absolument tout : |
| Line 51: | Line 48: |
| $ 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 ... |
$ hg log -v changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files: Makefile description: Create a makefile (...) $ hg log --debug changeset: 1:82e55d328c8ca4ee16520036c0aaace03a5beb65 tag: tip parent: 0:0a04b987be5ae354b710cefeba0e2d9de7ad41a9 parent: -1:0000000000000000000000000000000000000000 manifest: 1:0c7c1d435e6703e03ac6634a7c32da3a082d1600 user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files+: Makefile extra: branch=default description: Create a makefile (...) |
| Line 61: | Line 74: |
| Line 62: | Line 76: |
| * {{{files}}} liste les fichiers modifiés dans ce changeset. * {{{description}}} contient la description complète et multiligne du changeset plutôt que simplement la première ligne * Dans notre cas, les descriptions sont seulement longues d'une ligne, il n'y a donc pas beaucoup de différence. |
|
| Line 63: | Line 80: |
| * {{{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. |
La sortie `--debug` ajoute les champs suivants à la sortie verbeuse (cf. aussi [[DebuggingFeatures|Options de debugage]]): |
| Line 67: | Line 82: |
| Maintenant nous avons une idée plus claire de ce qui se passe, plongeons-nous dedans et faisons des modifications ! En avant, au ["TutorialPremiersChangements"] | * {{{changeset}}} donne maintenant le ChangeSetID non abrégé * deux champs {{{parent}}} indiquant le ChangeSetID de chaque parents de ce changeset où {{{-1:0000000000000000000000000000000000000000}}} réfère à un parent inexistant. * {{{manifest}}} donne le [[Manifest|manifest]] ID pour ce changeset. * {{{file+}}} liste le ou les fichiers ajoutés à ce changeset. * {{{file-}}} liste le ou les fichiers retirés dans ce changeset. La commande {{{log}}} vient avec une option {{{-r}}} pour voir les changesets spécifiques {{{ $ hg log -r1 changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile }}} <!> L'option {{{-r}}} supporte actuellement une syntaxe très flexible pour sélectionner un ensemble de changeset. Cependant, en raison du nombre limité de changeset disponibles dans notre dépôt d'exemple, nous sommes dans l'impossibilité de donner une bonne démonstration. Référez vous SVP à la [[http://www.selenic.com/mercurial/hg.1.html#log|manpage]] pour plus d'information. La commande {{{log}}} vient aussi avec une option {{{-p}}} pour montrer les patches associés aux changesets: {{{ $ hg log -r1 -p changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile diff -r 0a04b987be5a -r 82e55d328c8c Makefile --- /dev/null Fri Aug 26 01:20:50 2005 -0700 +++ b/Makefile Fri Aug 26 01:21:28 2005 -0700 @@ -0,0 +1,1 @@ +all: hello }}} Nous pouvons aussi utiliser la commande {{{tip}}} pour afficher des information sur le '''tip''', i.e. le dernier changeset. La commande {{{tip}}} peut être considérée comme un raccourci de notation pour {{{log -r tip}}}. {{{ $ hg tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile $ hg log -r tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile }}} Maintenant que nous avons une idée plus claire de ce qui se passe, plongeons-nous dedans et faisons des modifications ! En avant, au [[FrenchTutorialFirstChange]] ---- CategoryTutorial CategoryFrench CategoryFrench |
Ce document est une traduction du document original TutorialInstall
Tutorial - Examiner l'historique du dépôt
(Cette page est la partie 3 sur 9 de la série FrenchTutorial. La partie précédente est FrenchTutorialClone, la partie suivante est FrenchTutorialFirstChange)
A ce point, nous avons suivi FrenchTutorialClone pour cloner un dépôt. Notre copie locale est appelée mon-hello.
Regardons maintenant l'historique ce ce dépôt. Pour ce faire, nous utilisons la commande log. Ceci affiche un résumé de chaque évènement qui ont eu lieu dans le dépôt, en remontant dans le temps à partir du plus récent.
$ 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 quelques lignes de sortie ont besoin de quelques explications :
Chaque paragraphe décrit un changeset particulier. Un changeset est une modification de un ou plusieurs fichiers, groupés en une unité logique.
- Dans notre 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. Il s'agit d'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, et non 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, peu de changesets auront une é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), l'étiquette tip sera retirée du plus récent changeset et sera ajouté au nouveau changeset.
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.
parent définit le changeset parent. Dans certains cas, il en existe plus d'un, ce qui arrive lorsque vous fusionnez (merge) les changements depuis différents dépôts.
- La plupart du temps il n'y a qu'un seul changeset parent, qui est le changeset juste plus vieux que celui ci. C'est le cas pour notre exemple juste au dessus.
Nous pouvons avoir un historique plus détaillé en demandant une sortie verbeuse à l'aide de l'option -v, ou l'option globale --debug pour absolument tout :
$ hg log -v changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files: Makefile description: Create a makefile (...) $ hg log --debug changeset: 1:82e55d328c8ca4ee16520036c0aaace03a5beb65 tag: tip parent: 0:0a04b987be5ae354b710cefeba0e2d9de7ad41a9 parent: -1:0000000000000000000000000000000000000000 manifest: 1:0c7c1d435e6703e03ac6634a7c32da3a082d1600 user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files+: Makefile extra: branch=default description: Create a makefile (...)
La sortie verbeuse contient quelques champs de plus que la vue par défaut.
files liste les fichiers modifiés dans ce changeset.
description contient la description complète et multiligne du changeset plutôt que simplement la première ligne
- Dans notre cas, les descriptions sont seulement longues d'une ligne, il n'y a donc pas beaucoup de différence.
La sortie --debug ajoute les champs suivants à la sortie verbeuse (cf. aussi Options de debugage):
changeset donne maintenant le ChangeSetID non abrégé
deux champs parent indiquant le ChangeSetID de chaque parents de ce changeset où -1:0000000000000000000000000000000000000000 réfère à un parent inexistant.
manifest donne le manifest ID pour ce changeset.
file+ liste le ou les fichiers ajoutés à ce changeset.
file- liste le ou les fichiers retirés dans ce changeset.
La commande log vient avec une option -r pour voir les changesets spécifiques
$ hg log -r1 changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
L'option -r supporte actuellement une syntaxe très flexible pour sélectionner un ensemble de changeset. Cependant, en raison du nombre limité de changeset disponibles dans notre dépôt d'exemple, nous sommes dans l'impossibilité de donner une bonne démonstration. Référez vous SVP à la manpage pour plus d'information.
La commande log vient aussi avec une option -p pour montrer les patches associés aux changesets:
$ hg log -r1 -p changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile diff -r 0a04b987be5a -r 82e55d328c8c Makefile --- /dev/null Fri Aug 26 01:20:50 2005 -0700 +++ b/Makefile Fri Aug 26 01:21:28 2005 -0700 @@ -0,0 +1,1 @@ +all: hello
Nous pouvons aussi utiliser la commande tip pour afficher des information sur le tip, i.e. le dernier changeset. La commande tip peut être considérée comme un raccourci de notation pour log -r tip.
$ hg tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile $ hg log -r tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
Maintenant que nous avons une idée plus claire de ce qui se passe, plongeons-nous dedans et faisons des modifications ! En avant, au FrenchTutorialFirstChange