4. Exemples avancés de gestion des sources

4.1. Comment modifier sans risques le champ tag quand vous mettez à jour src-all

Si vous spécifiez par exemple tag=A dans votre fichier supfile, cvsup créera un fichier ``checkouts'' appelé checkouts.cvs:A, par exemple avec le champ tag=RELENG_4, un fichier de ``checkouts'' checkouts.cvs:RELENG_4 est généré. Ce fichier sera utilisé pour récupérer et/ou stocker l'information identifiant vos sources 4-STABLE.

En suivant le catalogue src-all, si vous souhaitez passer de tag=A à tag=B (A inférieur/supérieur à B important peu) et si votre fichier ``checkouts'' est checkouts.cvs:A, les opérations suivantes devront être effectuées:

1. # mv checkouts.cvs:A checkouts.cvs:B (ceci fournit à l'étape suivante le fichier ``checkouts'' approprié)

2. Ecrivez un fichier supfile dont la ligne désignant le catalogue est:

   src-all tag=B
   

3. Cvsupez vos sources en utilisant le nouveau supfile.

Cvsup recherchera checkouts.cvs:B -- dans ce cas la cible est B, c'est à dire que cvsup se servira des informations contenues dans ce fichier pour gérer correctement vos sources.

Les avantages:

• Les sources sont traitées correctement (en particulier aucun fichier obsolète).

• Moins de charge sur le serveur, dans ce cas CVSup agit de la manière la plus efficace.

Par exemple, A=RELENG_4, B=., le point dans B=. signifie -CURRENT. C'est une mise à jour plutôt typique de la branche 4-STABLE vers la branche -CURRENT. Alors qu'il est simple de revenir à une ancienne version de sources (e.g. -CURRENT vers -STABLE), il n'en va pas de même avec le système. Vous êtes FORTEMENT déconseillé de tenter une telle opération, à moins que vous ne sachiez exactement ce que vous faites.

4.2. Mettre à jour en conservant le même champ tag mais pour une date différente

Si vous souhaitez basculer du champ tag=A au champ tag=A avec une date GMT différente (disons date=D) vous exécuterez ce qui suit:

1. Ecrivez un supfile dont la ligne désignant le catalogue est:

   src-all tag=A date=D
   

2. Mettez à jour vos sources en utilisant le nouveau supfile.

Que la nouvelle date précède ou non celle de la dernière synchronisation avec le champ tag=A est peu important. Par exemple, afin d'indiquer la date du ``27 Août 2000 à 10h00s00 GMT'' vous écrirez la ligne:

src-all tag=RELENG_4 date=2000.08.27.10.00.00

Qu'une date soit spécifiée ou non, le fichier ``checkouts'' est appelé checkouts.cvs:A (e.g. checkouts.cvs:RELENG_4). Comme conséquence, aucune action particulière n'est nécessaire afin de retourner à l'état précédent: vous devez modifier la date dans le supfile et remettre à jour à nouveau.

4.3. Mise à jour de votre catalogue des logiciels portés pour la première fois

Comme les logiciels portés sont étiquetés ``.'' (i.e. -CURRENT), vous pouvez correctement les synchroniser en ajoutant le mot-clé date (Cf cvsup(1) pour le format exact), vous devriez spécifier une date aussi proche que possible que celle de ``l'expédition'' de votre catalogue de logiciel porté. Après que CVSup ait créé le fichier ``checkouts'' du catalogue des logiciels portés, qui est précisément le but de cette première opération de synchronisation, le champ date doit être retiré, toutes les mises à jour suivantes seront faites en douceur.

Si vous avez voulu chercher la petite bête dans ce texte, vous vous êtes probablement aperçu des problèmes potentiels du processus de mise à jour des sources. Un certain nombre de personnes ont eu réellement des problèmes. Vous avez été avertis. :-)