Utilisation de CVS

Cette partie ne s'applique qu'aux paquetages qui utilisent le serveur CVS de cvs.php.net.

Inclure le mot clé CVS $Id$ dans chaque fichier.

Le reste de cette partie suppose que vous avez les connaissances de base des tags CVS et des branches.

Les tags CVS sont utilisés pour identifier quelles versions des fichiers de votre paquetage appartiennent à une distribution (release) particulière. Ci-dessous se trouve la liste des tags CVS obligatoires ou suggérés :

RELEASE_n_n_n

(obligatoire) A utiliser pour identifier une release. Si vous ne l'utilisez pas, il n'y a aucun moyen de revenir en arrière et récupérer votre paquetage depuis le serveur CVS dans l'état dans lequel il était au moment de la release.

QA_n_n_n

(branche, optionnel) Si vous pensez que vous devez faire une release candidate (pre-release), faire une branche est peut être une bonne idée car cela permet d'isoler la release et y appliquer uniquement les corrections majeures avant la véritable release. Pendant ce temps les développements normaux peuvent se poursuivre dans le tronc principal.

MAINT_n_n_n

(branche, optionnel) Si vous avez besoin de faire une "micro-release" (par exemple 1.2.1 et ainsi de suite après 1.2), vous pouvez aussi, si votre tronc principal est trés actif et que vous ne voulez que des modifications mineures entre vos micro-releases, utiliser une branche pour cela.

Seul le tag RELEASE est obligatoire, le reste est recommandé pour vous simplifier la vie.

Ci-dessous se trouve un exemple décrivant comment utiliser les tags pour la release 1.2.0 du paquetage Money_Fast :

$ cd pear/Money_Fast
$ cvs tag RELEASE_1_2_0
T Fast.php
T README
T package.xml

En faisant celé, vous permettez au site web PEAR de vous faire continuer le processus de release.

Voici une exemple sur la façon de créer une branche QA :

$ cvs tag QA_2_0_0_BP
...
$ cvs rtag -b -r QA_2_0_0_BP QA_2_0_0
$ cvs update -r QA_2_0_0
$ cvs tag RELEASE_2_0_0RC1
...et ensuite on tague la release en cours, à partir de la même branche :
$ cvs tag RELEASE_2_0_0

Le tag QA_2_0_0_BP est un tag "point de dérivation" qui est le point de départ d'une branche. C'est toujours une bonne idée de démarrer une branche CVS depuis un tel point. Les branches de maintenance peuvent utiliser le tag RELEASE comme leur point de dérivation.

Commentaires d'En-tête (Previous) Exemple d'URLs (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.