HowTo – Utiliser le CVS d’AbulEdu

Préambule : Ce document n’est pas un cours exhaustif sur l’utilisation du système CVS (j’en suis bien incapable), mais une simple entrée en matière fondée sur un exemple. A vous ensuite d’approfondir… La démarche présentée utilise le logiciel winCVS. Elle est applicable sous Linux en utilisant gCVS des mêmes auteurs.

1 Configurer le logiciel winCVS

Télécharger le logiciel depuis le site http://www.wincvs.org et l’installer.

Créer un répertoire sur votre disque dur qui contiendra les projets téléchargés. Pour cet exemple : c:\testcvs.

Exécuter le logiciel depuis le raccourci placé sur le bureau ou depuis le menu démarrer/programmes/wincvs/wincvs.

La fenêtre du programme présente trois grandes zones, des barres d’outils et un menu que l’on va utiliser (on obtient la plupart du temps le même résultat en utilisant un bouton dans les barres d’outils, vous le trouverez bien). La version utilisée est en anglais mais cela ne devrait pas être un gros problème.

Choisir l’emplacement où seront écrits les fichiers téléchargés :

menu « View » « Browse location » « Change » puis choisir le répertoire c:\testcvs qui vient d’être créé. L’affichage du bloc « modules » fait apparaître maintenant « testcvs », la fenêtre de droite ne contient rien, c’est le contenu de c:\testcvs.

Configurer les préférences : c’est l’étape cruciale, si ça ne marche pas, c’est là qu’il faut regarder !

menu « Admin » <Preferences… » fait afficher une boîte à cinq onglets.

Onglet « General »

Liste « Authentication », choisir pserver.

Si votre ordinateur accède à internet via un proxy, cliquez sur le bouton « Settings » juste à droite et remplissez les champs avec vos paramètres (pour un serveur abuledu standard IP 192.168.0.1 Port 3128).

Champ « Path », tapez /home/cvs/leterrier

Champ « Host address » : cvs.rycks.com

Champ « User name » : anonymous

Le champ CVSROOT s’est rempli tout seul, il contient :

anonymous@cvs/rycks.com:/home/cvs/leterrier

Onglet « Globals »

Cochez l’option « Checkout text files with the Unix LF (0xa) » qui vous permettra de récupérer des fichiers-images corrects.

Onglet « CVS »

Champ « HOME » : c:\testcvs

Onglets suivants : inutilisés pour l’instant.

Validez par OK

Vérifier que ça marche : menu « Admin » « Login », une boîte s’affiche, cochez l’option « Force using the CVSROOT » et validez.

La connexion s’établit avec le serveur et un mot de passe est demandé : laissez le vide et validez.

Des messages se sont affichés dans la fenêtre du bas :

« Logging in to :pserver :anonymous@cvs.rycks.com :2401:/home/cvs/leterrier »

puis

« ***** CVS exited normally with code 0 ***** »

Si vous avez ce message, bingo ! la configuration « basique » est terminée, vous pouvez vous déconnecter (« Admin » « Logout ») et savourez votre première victoire sur CVS.

Si le code à la fin du message est 1, raté, il faut vérifier :

que vous avez accès à internet

que vous n’avez rien oublié

et rejouer.

2 Télécharger le projet lapins

(pourquoi celui-là ? parce qu’il pèse moins de 180 Ko, qu’il contient force dossiers ainsi que des images où vous pourrez vérifiez la qualité du téléchargement, cf. l’onglet « Globals » plus haut, que c’est un projet ancien et que c’est lui qui à donné son nom au terrier d’AbulEdu)

Choisir un projet : menu « Remote » « Checkout module… » fait apparaître une boîte (encore) à cinq onglets.

Onglet « Checkout settings » : dans la liste « Module name », tapez « lapins », le champ « Local folder » doit contenir « c:\testcvs »

Onglet « Checkout options », cochez « Force using the current CVSROOT », laissez les autres options décochées.

Onglet « General », tout est déjà rempli !

Onglet « Globals », ici aussi !

Connectez-vous à Internet et validez.

Si ça marche, un grand nombre de lignes s’afficheront en couleur en bas de l’écran, par exemple :

cvs checkout : Updating lapins (en orange)

U lapins/bilan.tcl (en vert)

A la fin, le message traditionnel “CVS exited… 0” vous indiquera que c’est fini. Vous avez réussi votre premier « Checkout » ! En cas d’erreur, un message sera affiché en orange (et en anglais) qui vous expliquera peut-être ce qui cloche…

3 Explorer le projet lapins

Dans la liste à gauche de l’écran est apparu sous testcvs un dossier lapins, cliquez dessus et sur le signe plus pour développer l’arborescence du projet.

Dans la liste de droite sont affichés les dossiers et les fichiers. Les noms de fichier sont précédés d’un crayon (non barré, le fichier n’est pas en lecture seule), d’un icône blanc (le fichier n’est pas modifié). A la suite du nom, une colonne Révision affiche 1.1 ou 1.2 ou … qui correspond au numéro de version du fichier sur le serveur CVS, 1.1 est la version d’origine, 1.3 signifie que le fichier a déjà été modifié deux fois. Tout l’intérêt de CVS tient dans la possibilité de revenir à une version précédente ou de voir les différences entre deux versions d’un même fichier. A la suite, une colonne Option contient –kb sur la ligne du fichier lapins.png puis Binary en status ce qui signifie que le fichier n’est pas un texte ordinaire et que winCVS ne doit pas le transformer lors du téléchargement si vous avez oublié de cocher l’option qui va bien dans l’onglet « Globals ».

La colonne « Tag » reste vide dans ce projet, il n’y a qu’une branche de développement utilisée. L’explication des branches dépasse le cadre de ce HowTo.

4 Modifier des fichiers

Vous pouvez modifier des fichiers directement en double-cliquant sur le nom, l’éditeur correspondant sera lancé à condition que le type de fichier soit reconnu bien sûr.

Ouvrez ainsi le fichier David.log et effacez la dernière ligne puis sauvez. L’icône du fichier est devenue rouge, ce qui signifie que le fichier a été modifié depuis son chargement.

Si vous êtes connecté, vous pouvez voir quelles modifications ont été apportées, pour cela, cliquez à droite sur le fichier puis sur « Diff selection » et validez. En bas de l’écran s’afficheront en rouge les lignes du fichier original et en bleu celles du fichier local (modifié).

Pour récupérer l’original d’un fichier que vous avez modifié, click droit puis « Update selection », cochez « Get the clean copy » et validez. Le fichier original est téléchargé, magique !

5 Publier vos modifications

Autant vous le dire tout de suite, vous ne pourrez pas le faire avec le compte anonymous que vous utilisez, sinon se serait la mort à très court terme de tous les projets libres ! (Je ne pense pas que les projets propriétaires ouvrent du tout leur CVS, à supposer qu’ils en utilisent.)

5 bis Publier vos modifications

Envoyez vos fichiers modifiés par courriel aux auteurs du terrier.

5 ter Publier vos modifications

Si vous désirez tout de même publier directement sur le CVS du terrier, il vous faudra obtenir du chef un compte d’utilisateur ainsi qu’un mot de passe. Une période probatoire d’une dizaine d’années et une caution d’un million d’euros plus tard, vous serez en possession du sésame. Voir le point suivant.

6 quarto Publier vos modifications

Nanti de votre login et mot de passe, modifiez dans les préférences le username : remplacez anonymous par le login.

Cliquez à droite sur le fichier modifié puis « Commit selection ». Dans la boîte, tapez un message qui sera affiché sur le site du CVS puis validez. Votre mode passe vous est demandé, validez et vos modifications sont enregistrées.

Si vous avez modifié plusieurs fichiers et désirez les publier tous en même temps, click-droit sur le nom du projet dans la liste de gauche puis sur comme précédement sur « Commit selection ».

7 Obtenir d’autres projet ou « Y a que du lapin ? »

A l’étape numéro 2, vous avez tapé « lapins » comme nom de module à télécharger, comment savoir ce qu’il faut taper pour charger un autre projet. pour cela, winCVS possède un bouton « … » à côté du champ « Module name ». En cliquant dessus une seconde boîte apparaît qui vous dit qu’il n’y a pas de « modules definition » car il a regardé dans c:\testcvs, cochez donc la case « Force using… » puis le bouton « Refresh » et … rien de plus, même message.

7 bis Obtenir d’autres projet ou « Y a que du lapin ? »

Comme il y a souvent plusieurs manières de trouver un renseignement, visitez la page http://cvs.rycks.com et cliquez sur le lien du CVSWEB. Dans la nouvelle page, déroulez la liste et cliquez sur Le Terrier, la liste de tous les modules hébergés apparaît sous la forme de dossiers. Chaque module possède le nom de son dossier principal ainsi vous trouverez « Aller » ou « aller2 ». Vous vérifierez très vite que le nom du module est sensible à la « casse » (majuscules/minuscules) et que les espaces n’existent pas dans les noms de module (c’est « A_nous_les_nombres » et pas « A nous les nombres »).

Muni du nom du module vous pourrez procéder au « Checkout » après avoir vérifié que vous êtes revenu à la racine de votre espace téléchargement (testcvs) en cliquant sur ce nom dans la liste à gauche. Un autre moyen est de modifier le « Local folder to checkout to » dans la boîte « Checkout ». Si vous ne le faites pas, vous risquez de ne plus vous y retrouver (ne riez pas, ça m’est arrivé…).

8 Et après…

Après, il vous faudra découvrir :

man CVS (1 590 000 pages trouvées par Google)

winCVS (64 200 pages)

HowTo winCVS (3 870 pages)

et nous aider à modifier la doc ;-)

Denis Chassac

contacts@pedagosite.net

HowTo – Utiliser le CVS d’AbulEdu

Denis Chassac

2004-03-12T15:25:00