cbbe543fce
Remplacement de toutes les phrases du style « Dernière modification le ... [par ...] » par <date value="from git" />, qui produit une phrase du genre à partir de l'historique du dépôt. Le « from git » n'a pas d'importance, c'est juste parce que la DTD de TML (que je préfère ne pas changer) exige un attribut value. Last-change: ignore this commit
160 lines
4.4 KiB
XML
160 lines
4.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
||
"tuteurs://DTD/tml.dtd">
|
||
<html>
|
||
<head>
|
||
<title>RCS</title>
|
||
</head>
|
||
<body>
|
||
|
||
<h1>Le contrôle de versions : RCS (<em>Revision Control System</em>)</h1>
|
||
|
||
<p>
|
||
C'est un programme très simple mais puissant qui permet de garder
|
||
l'historique d'un fichier. Son intérêt est que vos fichiers évoluent au fur et
|
||
à mésure que vous les modifiez, et sans un outil de gestion de version, on
|
||
peut difficilement gérer les anciennes versions.
|
||
</p>
|
||
|
||
<h2><a name="base">Commandes de base</a></h2>
|
||
|
||
<p>
|
||
Sans trop rentrer dans les détails (pour cela, faire <code>man
|
||
rcsintro</code>), l'utilisation de base peut se résumer à deux
|
||
commandes : </p>
|
||
|
||
<h3><a name="ci">Enregistrer le fichier</a></h3>
|
||
|
||
<p> <code>ci</code> (de l'anglais <em>check-in</em>) est la
|
||
commande avec laquelle on dépose la dernière version du fichier dans l'archive
|
||
gérée par RCS.</p>
|
||
|
||
<p>
|
||
Supposons que notre fichier s'appelle <code>monfichier</code>. Voilà ce qui se
|
||
passe la première fois que l'on fait le check-in : (en <em>italique</em>,
|
||
ce qui est tapé par l'utilisateur) :</p>
|
||
|
||
<pre>
|
||
<span class="prompt">corvette ~ $</span> <em>ci monfichier </em>
|
||
RCS/monfichier,v <-- monfichier
|
||
initial revision: 1.1
|
||
enter description, terminated with ^D or '.':
|
||
NOTE: This is NOT the log message!
|
||
>><em>Ceci est une description du fichier</em>
|
||
>> <em>.</em>
|
||
done
|
||
<span class="prompt">corvette ~ $</span>
|
||
</pre>
|
||
|
||
<p>
|
||
Comme vous le voyez, <strong>la dernière ligne doit être un point</strong>,
|
||
afin de signaler au programme qu'on a fini d'écrire nos commentaires.
|
||
</p>
|
||
|
||
|
||
<p>
|
||
Le fichier est sauvé dans l'archive RCS, appelée <code>monfichier,v</code>, et
|
||
effacé. Par défaut, l'archive se trouve dans le même répertoire que le
|
||
fichier de départ. Il est plus pratique d'avoir un <strong>sous-répertoire
|
||
<code>RCS/</code></strong>, dans lequel seront sauvegardées automatiquement
|
||
les versions de vos fichiers.
|
||
</p>
|
||
|
||
<p>
|
||
La première fois que vous enregistrez un fichier, donnez une description
|
||
générale du fichier. Les autres fois, vous mettrez juste un commentaire sur la
|
||
version (modifications apportées, date, etc).
|
||
</p>
|
||
|
||
<h3><a name="co">Récupérer le fichier</a></h3>
|
||
<p><code>co</code> (de l'anglais <em>check-out</em>) est la
|
||
commande avec lequel on récupère une version du fichier dans l'archive gérée
|
||
par RCS.</p>
|
||
|
||
<p>
|
||
Supposons que vous voulez sortir la toute dernière version de notre fichier,
|
||
appelé <code>monfichier</code>. </p>
|
||
|
||
<pre>
|
||
<span class="prompt">corvette ~ $</span> <em>co monfichier </em>
|
||
RCS/monfichier,v --> monfichier
|
||
revision 1.1
|
||
done
|
||
<span class="prompt">corvette ~ $</span>
|
||
</pre>
|
||
|
||
<p>
|
||
La version 1.1 de <code>monfichier</code> est rétablie dans le répertoire
|
||
courant.
|
||
</p>
|
||
|
||
<p>
|
||
RCS ne sauvegarde pas des copies intégrales de chacune des versions :
|
||
chaque nouvelle version contient en fait les différences par rapport à la
|
||
précédente. C'est ce qui permet de gérer les différentes versions, sans
|
||
utiliser inutilement de la place disque en stockant 10 fois les mêmes données.
|
||
</p>
|
||
|
||
<h2><a name="faq">FAQ</a></h2>
|
||
|
||
<ul>
|
||
|
||
<li> <strong>Lisez bien les messages de RCS :</strong> s'il dit
|
||
|
||
<pre>
|
||
writable monfichier exists; overwrite? [ny](n)
|
||
</pre>
|
||
|
||
c'est qu'il y a déjà un fichier de ce nom dans le répertoire. Il vaut mieux
|
||
répondre <code>n</code>on et vérifier <em>avant</em> si on peut
|
||
l'écraser.</li>
|
||
|
||
<li> <strong>Vous ne voulez pas que le fichier soit effacé après le
|
||
dépôt</strong>. Il faut taper :
|
||
|
||
<pre>
|
||
ci -u monfichier
|
||
</pre>
|
||
|
||
Le fichier contenant les dernières modifications est sauvegardé normalement,
|
||
et vous conservez dans votre répertoire le fichier dans son dernier
|
||
état.</li>
|
||
|
||
|
||
<li> <strong>Vous voulez rétablir la version 1.4 et pas la plus
|
||
récente</strong>. Tapez :
|
||
|
||
<pre>
|
||
co -r1.4 monfichier
|
||
</pre></li>
|
||
|
||
<li> <strong>Vous voulez un historique des versions</strong>, avec les
|
||
commentaires que vous aviez mis. Tapez :
|
||
|
||
<pre>
|
||
rcslog monfichier
|
||
</pre></li>
|
||
|
||
<li> <strong>En quoi <code>monfichier</code> diffère-t-il actuellement de la version
|
||
1.3 ?</strong> Tapez :
|
||
|
||
<pre>
|
||
rcsdiff -r1.3 monfichier
|
||
</pre></li>
|
||
|
||
</ul>
|
||
|
||
<p>
|
||
Pour plus d'informations, vous pouvez consulter le <a
|
||
href="http://www.freenix.org/unix/linux/HOWTO/mini/RCS.html">Mini-HOWTO
|
||
RCS</a>.</p>
|
||
|
||
<div class="metainformation">
|
||
Auteur : Roberto Dicosmo (1993?). <date value="from git" />
|
||
</div>
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|