Archiver les changements
Jusqu'à présent, si vous avez suivi les exemples, nous avons créé une
nouvelle archive et un projet hello-world. Dans cette archive,
nous avons importé la version initiale de hello-world.
L'opération la plus courante que vous aimerez effectuer en tant que
programmeur utilisant un système de contrôle de révision est
d'archiver (commit) un ensemble de modifications. Dans ce
chapitre, nous verrons les méthodes les plus basiques pour effectuer
cela.
si vous regardez le source, vous noterez une faute d'orthographe et un
bogue sur le retour à la ligne :
% cat hw.c
#include <stdio.h>
void
hello_world (void)
{
(void)printf ("hello warld");
}
C'est clair, nous voulions dire « hello world », pas « hello warld »,
et nous voulions probablement un retour à la ligne à la fin du
message. Réparons ces bogues maintenant.
Les conseils gratuits méritent d'être payés
anonyme
Voilà le plan : nous modifierons le source
pour réparer les bogues. Ensuite nous demanderons à arch d'archiver
les modifications nécessaires pour réparer ces bogues. Cette seconde
étape va créer une nouvelle révision dans l'archive.
Comme nous l'avons noté précédement, à chaque fois que vous créez une
nouvelle révision, vous devez fournir un message de log pour cette
révision (voir « Créer le premier fichier de log »).
Les bogues particuliers que nous sommes en train de réparer dans notre
exemple ludique sont simplistes -- mais dans une situation réelle, ils
seront sûrement plus complexes. Nous avons le choix : vous pouvez
soit attendre que les modifications soient effectuées pour écrire le
message de log décrivant vos changements, soit écrire le message de
log au fur et à mesure.
Voici le conseil gratuit : écrivez le message de log au fur et à
mesure. En d'autres termes, prenez des notes en cours de travail. Au
niveau des commandes tla ça signifie que vous devez démarrer le
processus de correction des bogues par :
% cd ~/wd/hello-world
tla make-log
++log.hello-world--mainline--0.1--lord@emf.net--2003-example
Ensuite éditez votre nouveau fichier de log pour y lire :
Summary: Réparation des bogues dans la chaine "hello world"
Keywords:
Le « Summary » décrit ce que vous êtes censé effectuer comme nouvelles
modifications. En cours de travail, vous pouvez remplir le corps du
message de log.
Mettons que ces bogues soient plus complexes qu'ils ne le sont
actuellement, voilà comment le travail pourrait se dérouler :
Change warld en world.
Mise à jour du message de log.
Ajoutez une note au fichier de log :
Summary: Réparation des bogues dans la chaine "hello world"
Keywords:
Écriture correcte de "world" (et non "warld").
Ajout d'un retour à la ligne à la chaine.
Mise à jour du message de log à nouveau.
Summary: Réparation des bogues dans la chaine "hello world"
Keywords:
Écriture correcte de "world" (et non "warld").
Ajout d'une nouvelle ligne à la chaine "hello world"
Vous venez juste d'effectuer un long et difficile travail pour
réparer ces bogues. Ne serait-ce pas une bonne idée que de revoir ce
que vous avez fait avant de le publier ?
Pas de problème, arch est là pour ça :
% tla changes --diffs
[....]
*** patched regular files
**** ./hw.c
[....]
@@ -4,7 +4,7 @@
void
hello_world (void)
{
- (void)printf ("hello warld");
+ (void)printf ("hello world\n");
}
[....]
Aha ! maintenant nous savons. C'est le moment d'archiver ces
modifications.
Maintenant, enregistrons ces changements dans l'archive.
Si vous n'avez pas tenu compte de notre conseil gratuit (voir
Quelques conseils gratuits sur les messages de log), c'est
maintenant le moment de créer le message de log (astuce : tla
make-log).
Pour sauvegarder vos changements dans l'archive, simplement :
% tla commit
[....]
Après ce commit, il y a une nouvelle révision dans l'archive.
% tla revisions hello-world--mainline--0.1
base-0
patch-1
ou, en plus détaillé :
% tla revisions --summary hello-world--mainline--0.1
base-0
initial import
patch-1
Réparation des bogues dans la chaine "hello world"
Notre arborescence de patch-log a également été mise à jour :
% tla logs hello-world--mainline--0.1
base-0
patch-1
% tla logs --summary hello-world--mainline--0.1
base-0
initial import
patch-1
Réparation des bogues dans la chaine "hello world"
Impression