Traduction du tutoriel Arch de Thomas Lord

Créer une nouvelle archive

Une archive est un répertoire dédié utilisé par arch pour maintenir une bibliothèque contenant les modifications (changesets) et les arborescences de vos projets. Ce chapitre explique comment créer une nouvelle archive.

Choisir un emplacement

Vous devez choisir où sera placée votre archive, dans quel répertoire elle sera rangée.

Astuce

Il est fort probable que vous souhaitiez travailler avec plusieurs archives. Raison pour laquelle c'est une bonne idée de créer un répertoire dans lequel vos archives seront rangées.

Dans les exemples qui suivent, nous allons créer une archive qui sera un sous-répertoire de ~/{archives}, ce dernier étant le répertoire où nous rangeons toutes nos archives.

Créons donc tout d'abord {archives} :

% mkdir ~/{archives}

Choisir un nom pour une archive

L'étape suivante consiste à faire le choix d'un nom pour votre archive. Un nom d'archive est constitué d'une adresse courriel, suivie par deux tirets (--), puis par un suffixe. Par convention, l'adresse courriel devrait être celle du propriétaire de l'archive.

Dans cet exemple, nous utiliserons le nom suivant :

lord@emf.net--2003-example

Indication

Si vous utilisez une seule archive pendant un grand laps de temps elle risque d'accumuler une grande quantité d'information. L'utiliser ainsi risque de devenir difficile. Grâce à la souplesse de arch, il n'est pas indispensable de tout conserver dans une seule et même archive. C'est donc une bonne idée d'envisager la division des archives par date. Ceci implique que vous intégriez une date dans le nom de l'archive. Dans l'exemple ci-dessus, l'archive est marquée « 2003 » : un an plus tard, on pourra créer lord@emf.net--2004-example et continuer le projet dans cette nouvelle archive. L'archive de 2003 continuera d'exister -- on cessera simplement d'y ajouter des informations.

On devrait par ailleurs choisir les noms de archives de manière à les distinguer, pour permettre de travailler avec plusieurs archives. Le suffixe « -example » ci-dessus nous indique que l'archive est créée uniquement pour nous aider à pouvoir travailler avec les exemples tout au long de ce tutoriel.

Créer l'archive

Pour créer une nouvelle archive, on utilise la commande make-archive, en lui indiquant le nom de l'archive et son emplacement:

# Créer la nouvelle archive
#
% tla make-archive lord@emf.net--2003-example ~/{archives}/2003-example

En faire votre archive par défaut

Afin de nous éviter de saisir le nom de l'archive à chaque commande, on déclare que cette nouvelle archive est notre archive par défaut :

% tla my-default-archive lord@emf.net--2003-example

On peut consulter le nom actuel de l'archive par défaut en tapant :

% tla my-default-archive
lord@emf.net--2003-example

On peut annuler ce réglage avec la commande :

% tla my-default-archive -d
user default archive removed

(Si vous jouez avec l'option -d, veillez à rétablir notre archive d'exemple par défaut, afin de pouvoir continuer de suivre le tutoriel.)

Comment ça marche ? -- De nouvelles archives

Examinons ce que font réellement ces commandes.

Tout d'abord, tla sait maintenant que la nouvelle archive existe :

Quelles sont les archives que tla connaît ?

% tla archives
lord@emf.net--2003-example
    /home/lord/{archives}/2003-example

% tla wheris-archive lord@emf.net--2003-example
/home/lord/{archives}/2003-example

Où est rangée l'information ?

 % ls ~/.arch-params
 =default-archive          =id          =locations

 % cat ~/.arch-params/=default-archive
lord@emf.net--2003-example

 % ls ~/.arch-params/=locations
 lord@emf.net--2003-example

 % cat ~/.arch-params/=locations/lord@emf.net--2003-example
 /home/lord/{archives}/2003-example

Le répertoire de l'archive a été créé et contient de nouveaux fichiers :

% ls ~/{archives}
2003-example

% ls -a ~/{archives}/2003-example
.                   .archive-version
..                  =meta-info

% cat ~/{archives}/2003-example/.archive-version
Hackerlab arch archive directory, format version 2.

% ls -a ~/{archives}/2003-example/=meta-info/
.        ..        name

% cat ~/{archives}/2003-example/=meta-info/name
lord@emf.net--2003-example

Attention!

Il est en général préférable de ne pas éditer les fichiers contenus dans ~/.arch-params/ ou dans l'archive, à la main.

Version du 18/09/2004 21h14 : wilk@flibuste.net--libre   docs-tla--fr--1.0     patch-102 ... base-0