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

262 lines
6 KiB
Text
Raw Normal View History

<?xml version="1.0" encoding="UTF-8"?>
2005-09-16 14:25:45 +02:00
<!DOCTYPE html
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
"tuteurs://DTD/tml.dtd">
<html>
<head>
<title>Subversion</title>
</head>
<body>
<h1>Contrôle de versions avec Subversion</h1>
2005-09-16 14:25:45 +02:00
<p>
Le logiciel Subversion permet de gérer l'évolution de projets et leurs
différentes versions. Si vous connaissez <a
href="&url.tuteurs;logiciels/rcs">RCS</a> ou <a
href="&url.tuteurs;logiciels/cvs">CVS</a>, Subversion entend leur
succéder et en moderniser le principe.
2005-09-16 14:25:45 +02:00
</p>
<h2>Préliminaires à l'utilisation de Subversion</h2>
2005-09-16 14:25:45 +02:00
<h3>Créer un répertoire de dépôt</h3>
2005-09-16 14:25:45 +02:00
<p>
Pour gérer l'évolution de projets (qu'il s'agisse de fichiers TeX, de
2005-09-16 14:25:45 +02:00
programmes ou de scripts en n'importe quel langage, etc.), il faut
d'abord, comme sous CVS, créer un répertoire de dépôt.
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> mkdir svn
<span class="prompt">bireme ~ $</span> svnadmin create svn
<span class="prompt">bireme ~ $</span>
</pre>
<p>
Vous avez maintenant un répertoire de dépôt prêt à recevoir vos projets.
2005-09-16 14:25:45 +02:00
</p>
<h3>Ajouter des projets</h3>
<p>
Pour ajouter des projets à Subversion, allez d'abord dans le répertoire
contenant les fichiers du projet (s'ils existent). Dans notre exemple,
disons que vous avez un répertoire nommé <code>mon_projet</code>, qui
contient un seul fichier, intitulé <code>fichier1</code>.
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn import mon_projet file:///users/promo/section/login/svn -m "version0"
Adding mon_projet/fichier1
Committed revision 1.
<span class="prompt">bireme ~ $</span>
</pre>
<p class="continue">
Maintenant, vous avez :
2005-09-16 14:25:45 +02:00
</p>
<ul>
<li> un répertoire de dépôt ;</li>
<li> un projet déposé dans ce dernier.</li>
2005-09-16 14:25:45 +02:00
</ul>
<p>
Vous pouvez déposer autant de projets que vous le désirez dans votre
répertoire de dépôt.
2005-09-16 14:25:45 +02:00
</p>
<h3>Créer des répertoires de travail</h3>
2005-09-16 14:25:45 +02:00
<p class="continue">
Il ne vous reste plus qu'à créer un (ou plusieurs) répertoire(s) de
travail :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn checkout file:///users/promo/section/login/svn svn-travail
A mon_projet/fichier
Checked out revision 1.
<span class="prompt">bireme ~ $</span>
</pre>
<p>
Évidemment, vous pouvez travailler sur un projet même si le répertoire
de dépôt n'est pas chez vous. Pour cela, tapez simplement l'URL du
projet. En voici quelques exemples :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn checkout http:///adresse/repertoire/projet svn-travail
<span class="prompt">bireme ~ $</span> svn checkout https:///adresse/repertoire/projet svn-travail
<span class="prompt">bireme ~ $</span> svn checkout svn:///adresse/repertoire/projet svn-travail
<span class="prompt">bireme ~ $</span> svn checkout svn+ssh:///adresse/repertoire/projet svn-travail
</pre>
<p>
Vous récoltez ainsi tous les fichiers du projet. Modifiez-les de la
façon habituelle, typiquement avec un éditeur de texte.
2005-09-16 14:25:45 +02:00
</p>
<h2>Subversion au quotidien</h2>
<h3>Mettre à jour un répertoire de travail</h3>
2005-09-16 14:25:45 +02:00
<p>
Pour mettre à jour votre répertoire de travail, utilisez la
commande :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn update
</pre>
<p class="continue">
ou bien, si vous ne voulez mettre à jour qu'un nombre limité de
fichiers :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn update <em>fichier1 fichier2 etc.</em>
</pre>
<p>
Apportez les modifications que vous voulez sur les fichiers de votre
répertoire de travail.
2005-09-16 14:25:45 +02:00
</p>
<h3>Ajout et retrait de fichiers</h3>
<p>
Pour ajouter des fichiers, commencez par les créer, comme à
l'accoutumée. Par exemple, éditez le fichier <code>fichier2</code> et
remplissez-le (ou non). Ensuite, tapez :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn add fichier2
2005-09-16 14:25:45 +02:00
</pre>
<p class="continue">
Cette commande avertit Subversion qu'il devra prendre en compte ce
nouveau fichier. Le fichier sera ajouté au dépôt Subversion la prochaine
fois que vous taperez <code>svn commit</code>. Attention ! Si
vous ne tapez pas <code>svn commit</code>, le fichier ne sera pas
ajouté au dépôt !
</p>
2005-09-16 14:25:45 +02:00
<p>
Pour retirer des fichiers de Subversion, utilisez la commande :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn delete fichier
</pre>
<h3>Distribuer vos modifications</h3>
<p>
Quand vous avez terminé d'apporter vos modifications, vous pouvez les
distribuer :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn commit
</pre>
<p class="continue">
ou bien, si vous ne voulez distribuer qu'un nombre limité de
fichiers :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn commit <em>fichier1 fichier2 etc.</em>
</pre>
<h2>Fonctionnalités avancées de Subversion</h2>
2005-09-16 14:25:45 +02:00
<h3>Historique</h3>
<p>
Vous pouvez consulter l'historique d'un fichier :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn log <em>fichier</em>
</pre>
<p class="continue">
mais aussi de tous les fichiers d'un projet :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn log
</pre>
<h3>Comparaison de fichiers</h3>
<p>
Vous pouvez comparer deux versions d'un fichier, ici la première et la
deuxième versions :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn diff --revision 1:2 fichier
</pre>
<p>
Vous pouvez aussi comparer, par exemple, la dernière version distribuée
d'un fichier avec la précédente :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn diff --revision PREV:COMMITTED fichier
</pre>
<h3>Retour à la version antérieure</h3>
2005-09-16 14:25:45 +02:00
<p>
Si vous regrettez les modifications apportées à un fichier, tapez :
2005-09-16 14:25:45 +02:00
</p>
<pre>
<span class="prompt">bireme ~ $</span> svn revert <em>fichier</em>
</pre>
<p class="continue">
Le fichier reviendra à son état antérieur.
2005-09-16 14:25:45 +02:00
</p>
<h2>En savoir plus</h2>
<p>
Pour en savoir plus sur Subversion, consultez :
2005-09-16 14:25:45 +02:00
</p>
<ul>
<li> un ouvrage de référence : <a
2005-09-16 14:25:45 +02:00
href="http://svnbook.red-bean.com/">Version Control with Subversion</a>
(en anglais) ;</li>
2005-09-16 14:25:45 +02:00
<li> la page d'aide de Subversion : <code>svn help</code>.</li>
2005-09-16 14:25:45 +02:00
</ul>
<div class="metainformation">
Auteur : Baptiste Mélès.
<date value="from git" />
2005-09-16 14:25:45 +02:00
</div>
</body>
</html>