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.
Lorsque le fichier est édité, ajouter ce tag
s'il n'est pas déjà présent
(ou remplacer toute forme déjà existante du type
<< Dernière Modification : >>, etc.).
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 :
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 :
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.
