tuteurs.ens.fr/logiciels/cvs/index.tml

503 lines
13 KiB
Text
Raw Normal View History

2002-12-20 18:38:42 +01:00
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
"tuteurs://DTD/tml.dtd">
<html>
<head>
<title>CVS</title>
</head>
<body>
<h1>Le contr<74>le de versions avec CVS</h1>
2002-12-20 18:38:42 +01:00
2005-09-16 00:48:08 +02:00
<p><code>CVS</code> est un logiciel Unix pour g<>rer diff<66>rentes versions
de beaucoup de fichiers produits <20>ventuellement par de multiples
utilisateurs.</p>
2002-12-20 18:38:42 +01:00
<p>
Par exemple, les tuteurs informatique utilisent <code>CVS</code> pour
g<EFBFBD>rer ce site.
</p>
2005-09-16 00:48:08 +02:00
<h2>Pourquoi CVS&nbsp;?</h2>
<h3>L'enfer, c'est les autres</h3>
<p>
Supposons par exemple que vous conceviez un m<>moire de ma<6D>trise en
collaboration avec un camarade, ou encore que vous <20>criviez un programme
informatique en collaboration avec une <20>quipe de d<>veloppeurs. Plusieurs
sc<EFBFBD>narii-catastrophes peuvent <20>tre envisag<61>s, et vous pouvez <20>tre s<>r
qu'au moins l'un d'entre eux se r<>alisera t<>t ou tard&nbsp;:
</p>
<ol>
<li> l'un des contributeurs efface par erreur tout ou partie du travail
commun men<65> jusque l<>, alors m<>me que vous approchiez de son
terme&nbsp;;</li>
<li> un contributeur apporte des corrections <20> une version obsol<6F>te du
travail commun, car il ne savait pas o<> trouver la version la plus
r<EFBFBD>cente&nbsp;;</li>
<li> deux contributeurs travaillaient simultan<61>mlent sans le savoir, et
le deuxi<78>me a effac<61> sans le vouloir tout le travail du
premier&nbsp;;</li>
<li> un contributeur a commis de nombreuses erreurs, et l'on doit
revenir sur chacune de ses modifications, en esp<73>rant ne pas laisser
d'erreurs&nbsp;; </li>
<li>etc., etc.</li>
</ol>
<h3>La solution&nbsp;: CVS</h3>
<p>
L'id<69>al, pour <20>viter ces probl<62>mes, serait de pouvoir concilier deux
exigences apparemment contradictoires&nbsp;:
</p>
<ol>
<li> centraliser les versions officielles pour <20>viter toute
ambigu<EFBFBD>t<EFBFBD>&nbsp;;</li>
<li> d<>centraliser les versions de travail, sur lesquelles les
contributeurs apportent leurs modifications.</li>
</ol>
<p>
CVS r<>unit ces deux avantages, en respectant les principes
suivants&nbsp;:
</p>
<ol>
<li> centralisation des versions officielles&nbsp;;</li>
<li> num<75>rotation des versions&nbsp;;</li>
<li> possibilit<69> de retour <20> une version ant<6E>rieure&nbsp;;</li>
<li> gestion des conflits entre deux modifications contradictoires des
m<EFBFBD>mes fichiers&nbsp;;</li>
<li> d<>centralisation des r<>pertoires de travail, ce qui permet <20>
plusieurs utilisateurs de travailler simultan<61>ment, et de ne pas
officialiser les modifications tant qu'elles ne sont pas termin<69>es.</li>
</ol>
<p>
Pour vous initier <20> CVS, nous allons successivement vous pr<70>senter
comment mettre un projet sous CVS, puis comment travailler au quotidien
sous CVS.
</p>
<h2>Pr<50>liminaires <20> l'utilisation de CVS</h2>
<p>
Pour mettre des projets sous CVS, il faut proc<6F>der en deux temps&nbsp;:
</p>
<ol>
<li> cr<63>er un r<>pertoire de d<>p<EFBFBD>t&nbsp;CVS (en anglais
<em>repository</em>), o<> seront stock<63>es toutes les versions officielles
et leurs modifications&nbsp;;</li>
<li> ajouter <20> ce r<>pertoire les diff<66>rents projets que vous voulez
mener <20> l'aide de CVS.</li>
</ol>
<h3>Cr<43>er un r<>pertoire de d<>p<EFBFBD>t&nbsp;CVS (<em>repository</em>)</h3>
<p>
Commen<EFBFBD>ons par cr<63>er un r<>pertoire de d<>p<EFBFBD>t, c'est-<2D>-dire un r<>pertoire
o<EFBFBD> CVS stocke toutes les versions et leurs
modifications. Rassurez-vous&nbsp;: CVS investit toute son ing<6E>niosit<69>
pour r<>duire au maximum l'espace disque utilis<69>, en ne retenant <em>que
les modifications</em>, au lieu de recopier <20> chaque fois l'int<6E>gralit<69>
des fichiers d'un projet.
</p>
<p>
Pour cela, il faut d'abord cr<63>er mat<61>riellement ce r<>pertoire, par
exemple <code>$HOME/cvs</code>, puis cr<63>er la variable d'environnement
CVSROOT&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~ $</span> mkdir $HOME/cvs
<span class="prompt">bireme ~ $</span> CVSROOT="$HOME/cvs"
</pre>
<p>
Mais attention&nbsp;! dans ce cas, la variable CVSROOT dispara<72>tra quand
vous vous d<>loguerez ou fermerez le terminal courant. Aussi faut-il
<EFBFBD>crire dans votre fichier <code>.zshrc</code> (si vous utilisez
<code>zsh</code>, comme c'est le cas <20> l'ENS)&nbsp;:
</p>
<pre>
CVSROOT="$HOME/cvs"
</pre>
<p class="continue">
Une fois que ce r<>pertoire existe, il faut <20>&nbsp;faire les
pr<EFBFBD>sentations&nbsp;<3B> avec CVS. Tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~ $</span> cd cvs
<span class="prompt">bireme ~/cvs $</span> cvs init
</pre>
<p>
Maintenant, vous avez un r<>pertoire de d<>p<EFBFBD>t pr<70>t <20> recevoir et <20>
stocker les diff<66>rents projets. Il ne reste plus qu'<27> le remplir&nbsp;!
</p>
<h3>Cr<43>er un projet</h3>
<p>
Supposons que vous soyez en train de concevoir un projet nomm<6D>
<EFBFBD>&nbsp;turing-test&nbsp;<3B>, dont tous les fichiers sont r<>unis dans le
r<EFBFBD>pertoire <code>$HOME/programmation/turing-test</code>.
</p>
<p>
Tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~ $</span> cd programmation/turing-test
<span class="prompt">bireme ~/programmation/turing-test $</span> cvs import turing votre_nom version0
</pre>
<p>
Ainsi est cr<63><72> un r<>pertoire <code>$HOME/cvs/turing</code>
contenant des fichiers correspondant <20> ceux du r<>pertoire
<code>$HOME/programmation/turing-test</code>.
</p>
<p>
La mention <code>votre_nom</code> vous d<>signe&nbsp;; vous pouvez mettre
votre login, ou autre chose si vous pr<70>f<EFBFBD>rez.
</p>
<p>
Quant <20> la mention <code>version0</code>, il s'agit juste d'un nom pour
la version initiale&nbsp;: vous pouvez tout aussi bien mettre
<code>start</code>, <code>debut</code>, etc. Seule contrainte&nbsp;: le
premier caract<63>re doit <20>tre une lettre.
</p>
<h3>Cr<43>er un r<>pertoire de travail</h3>
<p>
Maintenant que vous avez cr<63><72> votre projet sous CVS, vous pouvez vous
cr<EFBFBD>er un r<>pertoire de travail.
</p>
<pre>
<span class="prompt">bireme ~ $</span> mkdir rep-travail
<span class="prompt">bireme ~ $</span> cd rep-travail
<span class="prompt">bireme ~/rep-travail $</span> cvs checkout turing
</pre>
<p>
La commande <code>cvs&nbsp;checkout&nbsp;<em>projet</em></code> cr<63>e un
r<EFBFBD>pertoire de travail pour le projet indiqu<71>. <strong>Vous pouvez en
cr<EFBFBD>er autant que vous voulez</strong> (si vous en avez vraiment
l'utilit<69>...). En particulier, plusieurs utilisateurs diff<66>rents peuvent
en cr<63>er&nbsp;: c'est pr<70>cis<69>ment ce qui fait l'int<6E>r<EFBFBD>t de CVS.
</p>
<h2>CVS au quotidien</h2>
<h3>Mettre <20> jour son r<>pertoire de travail</h3>
<p>
Avant de modifier les fichiers mis sous CVS, vous devrez <20> chaque fois
les mettre <20> jour, ce qui vous permet de partir de versions r<>centes de
ces fichiers. Pour mettre <20> jour votre r<>pertoire de travail,
tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs update turing
</pre>
<p class="continue">
Vous serez alors s<>r d'avoir des fichiers <20>&nbsp;jour.
</p>
<p>
Vous pouvez aussi ne mettre <20> jour qu'un fichier, ou une liste de
fichiers&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs update <em>fichier1 fichier2 etc</em>
</pre>
<p>
Vous pouvez encore indiquer en ligne de commande quel r<>pertoire mettre
<EFBFBD> jour&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs update -d ~/programmation/turing-test
</pre>
<p>
Cette derni<6E>re commande peut <20>tre int<6E>gr<67>e <20> un script, ce qui est tr<74>s
pratique si vous voulez que les modifications soient prises en compte <20>
plusieurs endroits diff<66>rents (par exemple, dans votre r<>pertoire de
travail et sur votre page web, si vous avez mis votre page web
sous&nbsp;CVS).
</p>
<h3>Ajouter des fichiers</h3>
<p>
Un projet est rarement fix<69> d<>s sa premi<6D>re version&nbsp;; aussi des
fichiers peuvent-ils s'ajouter aux fichiers int<6E>gr<67>s <20> l'origine (avec
la commande <code>cvs&nbsp;import</code>), d'autres en <20>tre retir<69>s.
</p>
<p>
Pour ajouter des fichiers, la fa<66>on de s'y prendre d<>pend de la nature
du fichier en question. En effet, si le fichier est un fichier binaire,
il ne sert <20> rien que CVS le lise ligne <20> ligne <20> chaque partage de
modifications pour v<>rifier s'il a chang<6E>&nbsp;; tandis que s'il s'agit
d'un fichier texte, CVS est l<> pour <20>a.
</p>
<p>
Par cons<6E>quent, si c'est un <strong>fichier texte</strong> (un texte
simple, un script, le code source d'un programme, un fichier TeX, etc.),
tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs add <em>fichier1 fichier2 etc</em>
</pre>
<p class="continue">
En revanche, si vous voulez <strong>ajouter un fichier binaire</strong>
(un fichier ex<65>cutable, un document PS, PDF, une image JPEG, PNG, etc.),
tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs add -kb <em>fichier1 fichier2 etc</em>
</pre>
<p>
Vous pouvez <strong>v<>rifier le statut</strong> des fichiers (binaires
ou non) avec la commande&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs status <em>fichier</em>
</pre>
<p class="continue">
Lisez le champ <20>&nbsp;Sticky Options&nbsp;<3B>. Si sa valeur est
<EFBFBD>&nbsp;(none)&nbsp;<3B>, c'est que votre fichier n'est pas d<>clar<61> comme
binaire&nbsp;; s'il vaut <20>&nbsp;-kb&nbsp;<3B>, c'est qu'il l'est.
</p>
<p>
Il arrive parfois que l'on oublie de d<>clarer comme binaires certains
fichiers, notamment lors de l'enregistrement du projet dans le
r<EFBFBD>pertoire de d<>p<EFBFBD>t&nbsp;CVS. Il n'est pas trop tard pour se
rattraper&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs update -kb <em>fichier1 fichier2 etc</em>
</pre>
<p class="continue">
Ce qui <20>quivaut <20> la succession de commandes suivante&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs admin -kb <em>fichier1 fichier2 etc</em><br/>
<span class="prompt">bireme ~/turing-test $</span> cvs update <em>fichier1 fichier2 etc</em>
</pre>
<h3>Retirer des fichiers</h3>
<p>
Pour retirer des fichiers, utilisez la commande&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs remove <em>fichier1 fichier2 etc</em>
</pre>
<h3>Partager les modifications</h3>
<p>
Quand vous avez termin<69> vos modifications et que vous estimez que le
monde est pr<70>t <20> les recevoir, partagez-les&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs commit
</pre>
<p class="continue">
Les modifications seront alors enregistr<74>es dans le r<>pertoire de d<>p<EFBFBD>t.
</p>
<p>
Vous pouvez aussi ne partager qu'un fichier, ou une liste de
fichiers&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs commit <em>fichier1 fichier2 etc</em>
</pre>
<h3>Nettoyer son r<>pertoire de travail</h3>
<p>
Si vous ne contribuez qu'occasionnellement <20> tel ou tel projet, vous
pouvez vouloir ne pas conserver en permanence une version d'un projet
donn<EFBFBD> dans votre r<>pertoire de travail. Pour vous en d<>barrasser, vous
avez bien s<>r la possibilit<69> d'effacer les fichiers d'une mani<6E>re
<EFBFBD>&nbsp;traditionnelle&nbsp;<3B>, au moyen de la commande
<code>rm</code>. Mais CVS propose un outil plus puissant&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs release -d turing
</pre>
<p>
2005-09-16 10:06:05 +02:00
Cette commande <strong>v<>rifie que vous avez bien partag<61> toutes vos
2005-09-16 00:48:08 +02:00
modifications avant d'effacer les fichiers de votre r<>pertoire de
2005-09-16 10:06:05 +02:00
travail</strong>. Ceci vous <20>pargne bien des migraines&nbsp;!
2005-09-16 00:48:08 +02:00
</p>
<p>
2005-09-16 10:06:05 +02:00
Si vous ne voulez pas effacer vos fichiers, mais simplement
<strong>v<>rifier qu'aucun fichier n'a <20>t<EFBFBD> modifi<66> sans <20>tre
partag<EFBFBD></strong>, tapez simplement&nbsp;:
2005-09-16 00:48:08 +02:00
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs release turing
</pre>
<p class="continue">
Cette commande annule le <code>cvs checkout</code>.
</p>
<h2>Fonctionnalit<69>s avanc<6E>es de CVS</h2>
<h3>Historique des modifications</h3>
<p>
CVS garde l'historique de toutes les modifications. Si vous voulez voir
l'historique complet, tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs log
</pre>
<p>
Vous pouvez aussi ne consulter l'historique que d'un fichier, ou d'une
liste de fichiers&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs log <em>fichier1 fichier2 etc</em>
</pre>
<p>
Devant vos yeux <20>bahis s'affichera alors la liste de toutes les versions
de ces fichiers, accompagn<67>es des commentaires d<>pos<6F>s par les
contributeurs.
</p>
<h3>Comparer des versions</h3>
<p>
Vous voulez savoir pr<70>cis<69>ment en quoi telle version d'un fichier
diff<EFBFBD>re de telle autre&nbsp;; pour cela, tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs diff -r 1.2 fichier
</pre>
<p>
Ainsi, vous pourrez comparer l'<27>tat actuel du fichier avec sa
version&nbsp;1.2. Mais vous pouvez aussi comparer deux versions
quelconques&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs diff -r 1.1 -r 1.2 fichier
</pre>
<h3>Revenir sur des modifications</h3>
<p>
Oups&nbsp;! Vous avez fait une erreur, et dans votre pr<70>cipitation, vous
l'avez d<>j<EFBFBD> partag<61>e. Heureusement, CVS permet de revenir <20> des versions
ant<EFBFBD>rieures. Tapez&nbsp;:
</p>
<pre>
<span class="prompt">bireme ~/turing-test $</span> cvs update -A fichier
<span class="prompt">bireme ~/turing-test $</span> rm fichier
<span class="prompt">bireme ~/turing-test $</span> cvs update -p -r1.1 fichier > fichier
<span class="prompt">bireme ~/turing-test $</span> cvs commit fichier
</pre>
<p>
Vous <20>tes maintenant pr<70>t <20> utiliser CVS. Sa puissance est telle que cet
outil est devenu l'un des standards incontournables. Profitez-en
bien&nbsp;!
</p>
<h2>Bibliographie</h2>
2002-12-20 18:38:42 +01:00
<p>
Vous pouvez acc<63>der <20> la petite documentation r<>dig<69>e par David Monniaux
<a href="doc-cvs.ps.gz">(au format <code>.ps.gz</code>)</a>.
</p>
<p>
La documentation officielle se trouve <a
href="http://www.cvshome.org/docs/manual/">l<>-bas</a>.
</p>
<div class="metainformation">
2005-09-16 00:48:08 +02:00
Auteurs<72>: Baptiste M<>l<EFBFBD>s, Jo<4A>l Riou. Derni<6E>re modification le
2005-09-16 10:06:05 +02:00
<date value="$Date: 2005-09-16 08:06:05 $" />.
2002-12-20 18:38:42 +01:00
</div>
</body>
</html>