2. Introduction

Si vous avez consulté le site de John Polstra et lu sa FAQ, vous avez pu avoir remarqué les questions 12 et 13.

En mettant à jour n'importe quelle “catalogue” - collection de sources (e.g. /usr/ports), cvsup(1) se sert des fichiers de “checkouts” relatifs afin d'effectuer le processus de mise à jour de la manière la plus efficace et la plus correcte possible. Dans cet exemple (/usr/ports), le fichiers de “checkouts” relatif est /usr/sup/ports-all/checkouts.cvs:. si votre répertoire de base est /usr.

Un fichier “checkouts” contient l'information sur l'état actuel de vos sources -- d'une certaine manière, une sorte de “photographie”. Cette information permet à cvsup de rechercher les mises à jour le plus efficacement. De plus, et c'est peut-être plus important, il permet à cvsup de gérer correctement vos sources en effaçant localement tout fichier qui n'est plus présent sur l'archive centrale, et de ce fait ne pas laisser de fichiers obsolètes sur votre système. En fait, sans un fichier “checkouts”, cvsup ne saurait PAS de quels fichiers votre catalogue est composé (Cf cvsup(1) pour plus de détails), et en conséquence, il ne pourrait PAS effacer de votre système ces fichiers qui ne sont plus présents sur l'archive centrale. Ils resteraient sur votre système (les fichiers obsolètes), et pourraient vous causer de subtiles échecs de compilation ou tout autre désagrément. Par exemple, ce problème est susceptible de se produire si vous mettez à jour votre catalogue de logiciels portés plusieurs semaines après que vous ayez eu vos CDROMs d'installation.

Il est donc recommandé que vous adoptiez la procédure en deux temps décrite dans la FAQ de CVSup (Cf Q12, Q13); dans les sections suivantes, on vous présentera des exemples concrets intéressant et instructifs.