CVS est un programme pour aider à la modification simultanée de documents par plusieurs personnes. Chaque utilisateur crée une copie locale des documents. Ces copies peuvent être sur la même machine, ou aux quatre coins du monde. Les utilisateurs peuvent alors modifier leur copie locale comme ils le souhaitent, et quand la version modifiée est prête, enregistrer leurs changements sur le serveur.
Pour un accès en lecture seule, il est possible d'utiliser l'interface web. Il existe
également de nombreux clients CVS graphiques, comme par exemple celui de KDE,
cervisia.
Ce document décrit la procédure à suivre avec le programme en ligne de
commande cvs ; les autres clients fournissent des
fonctionnalités similaires.
CVS ne vous laissera pas enregistrer vos modifications si la version originale a été modifiée depuis votre dernière mise à jour. Ce n'est normalement pas un problème parce que vous pouvez mettre à jour votre copie locale. Si vos propres changements sont dans des zones du fichier différentes des modifications sur le fichier original, celles-ci sont silencieusement répercutées sur votre copie locale. Si les changements affectent la même zone, vous êtes averti qu'il y a conflit et que vous devez éditer le fichier pour corriger le problème avant d'enregistrer vos modifications.
Dans ce qui suit, un accès anonyme (par le compte « anonymous ») sera utilisé comme exemple. Si vous avez accès à un autre compte qui vous donne une permission en écriture dans le référentiel CVS, alors vous devriez utiliser ce compte à la place. Si vous pensez faire des changements, vous devriez commencer par obtenir un compte, puisque les utilisateurs anonymes ne peuvent pas enregistrer leurs changements. Consultez la section sur la permission en écriture pour plus d'informations.
Pour commencer à utiliser CVS, vous devez d'abord faire un
login sur le serveur CVS
cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml login
(appuyez simplement sur la touche Entrée pour le mot de passe « password » du compte « anonymous »)
Pour récupérer une copie de fichiers wml sur votre machine locale, vous devez utiliser
cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout webwml
Vous pouvez ne récupérer qu'une partie des pages en faisant :
cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout -l \
webwml webwml/<langue>
cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \
webwml/Perl webwml/english/template webwml/<langue>/Pics
cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \
webwml/<langue>/<chemin des fichiers désirés>
Répétez la dernière étape pour chacun des répertoires ou fichiers que vous voulez récupérer. La deuxième ligne permet d'avoir tous les fichiers nécessaires à la génération des fichiers HTML à partir des sources WML. Cette récupération partielle n'est pas vraiment la méthode officielle de travailler, donc il se peut que les instructions données ci-dessus ne marchent pas toujours.
Si on vous a donné un nom d'utilisateur et un mot de passe, tapez celui-ci à la place de anonymous, comme ceci :
cvs -d :ext:nom_utilisateur@cvs.alioth.debian.org:/cvsroot/webwml checkout webwml/english/doc
À partir de là, vous n'aurez plus besoin d'utiliser la partie
-d :ext:.... De temps en temps vous voudrez faire un
cvs update -d
pour récupérer les fichiers qui ont changé. L'option -d
ajoutera les nouveaux répertoires éventuels, automatiquement.
Vous pouvez créer un fichier ~/.cvsrc afin de ne pas avoir
à taper les mêmes options à chaque fois. Par exemple, il peut contenir
cvs -z9 update -d -P diff -u
La suite concerne ceux qui ont une permission en écriture dans le référentiel CVS. Quand vous en avez fini avec une page, vous pouvez enregistrer vos modifications dans le référentiel en utilisant
cvs commit <file>.wml
ou
cvs commit <dir> (pour enregistrer toutes les modifications dans <dir>)
ou
cvs commit (pour enregistrer toutes les modifications dans le répertoire courant)
Si vous êtes la première personne à traduire une page, vous aurez besoin de faire un
cvs add <file>.wml
avant de pouvoir l'enregistrer. Notez que cvs add n'est
pas récursif donc vous aurez besoin d'ajouter un répertoire avant de
pouvoir ajouter son contenu.
Pour plus d'information sur CVS, utilisez info cvs.
Pour obtenir un accès en écriture sur le site web, veuillez
demander à rejoindre le projet webwml sur Alioth.