deniger
2002-12-11
Les commandes de base de CVS et quelques conseils.

FudaaCVS: les commandes

Login/Logout

L'accès au serveur CVS se faisant par l'intermédiaire de ssh, les commandes login/logout ne doivent pas être utilisées.

Mise à jour des sources: update

Vous devez mettre à jour régulièrement tous vos sources. La commande update permet d'intégrer les dernières modifications des autres développeurs dans votre copie locale des sources.

  • !Il peut arriver que deux développeurs aient modifier la même portion de code dans un même fichier. Alors CVS le signale en marquant un C (conflict) devant le nom du fichier, dans le listing de la commande update. Il faut alors gérer le conflit à la main en éditant le fichier.

Linux

Dans votre répertoire de travail, pour updater récursivement tous les répertoires, il faut taper:

cvs_sf update

cvs_sf étant un script sh décrit dans le document d'installation de CVS/ssh.

  • !Les options par défaut de vos commandes son regroupées dans le fichier $HOME/.cvsrc

Windows

Il faut sélectionner le dossier à updater puis cliquer sur Modify/Update selection ou sur l'icone à la flèche verte. Bien vérifier les options (Update Settings).

Intégration de vos modifications au repository

Pour que vos modifications soient intégrées au code source partagé par tous les développeurs, il faut "commiter" vos sources locaux. Vous devez commiter vos modifications régulièrement, deux fois par semaine, pour ne les laissez pas s'accumuler et rencontrer des conflits par la suite.

  • !!!Avant tout commit, il faut faire un update, recompiler, et bien vérifier qu'il n'y pas eu de conflit et que tout compile bien.
  • !!! ON NE COMMITE JAMAIS DU CODE QUI NE COMPILE PAS!!. Si votre code ne compile pas, attendez de l'avoir réparé pour le commiter, sinon les autres développeurs hériteront de votre code erroné et ne pourront plus compiler non plus.

Linux

-cvs_sf commit

Windows

-Sélectionner le dossier à commiter et cliquez sur Modify/Commit selection ou sur l'icone à la flèche rouge.

Ajout ou retrait d'un fichier ou d'un répertoire

  • !Pour renommer un fichier, vous devez ajouter le fichier avec le nouveau nom puis supprimer l'ancien fichier.
  • !N'oubliez pas de commiter après vos ajouts/suppressions.

Linux

-Pour ajouter un nouveau fichier ou répertoire au repository CVS:

cvs_sf add <fichier>

-si vous avez effacé des fichiers et voulez les détruire aussi sur le repository:

cvs_sf remove <fichiers>

-Raccourci pour effacer vos fichiers de vos sources et en même temps du repository:

cvs_sf remove -f <fichiers>

Windows

Pour modifier ou supprimer un (des) fichier(s), vous devez les sélectionner puis aller dans le menu Modify ou cliquer sur le bouton droit de la souris.

L'aide CVS

Linux

L'aide de CVS est très bien faite. la syntaxe de toutes les commandes est bien expliquée.

cvs --help

est le point d'entrée de l'aide. Pour connaître la syntaxe d'une commande particulière:

cvs -H <commande>

Windows

Le menu Help ....

Etiquette

Il est essentiel de respecter un minimum de règles pour garantir la cohérence du projet.

  • !!! Updater régulièrement ses sources (avant chaque session de travail et avant chaque commit).
  • !!! Recompiler tout après chaque update (si des fichiers ont changé bien sûr).
  • !!! Commiter régulièrement.
  • !!! Ne pas commiter si ça ne compile pas.
  • !!! Respecter les fichiers écrits par les autres. Si vous voulez faire une modification sur un fichier écrit par un autre développeur, parlez-en avec lui avant.