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

<?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>

<p>
Attention, ce logiciel est assez ancien et peu utilisé de nos jours.
Pour une utilisation personnelle à la manière de ce tutoriel, on utilise plus souvent <a href="../git/">git</a>.
</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 &lt;-- monfichier
initial revision: 1.1
enter description, terminated with ^D or '.':
NOTE: This is NOT the log message!
&gt;&gt;<em>Ceci est une description du fichier</em>
&gt;&gt; <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 --&gt; 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>
-												Passage en UTF-8, 2 : lignes <?xml encoding?>

Last-change: ignore this commit

											
										
										
											2009-09-20 12:34:28 +02:00
+								<?xml version="1.0" encoding="UTF-8"?>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								<!DOCTYPE html
 								  PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
 								  "tuteurs://DTD/tml.dtd">
 								<html>
 								  <head>
 								    <title>RCS</title>
 								  </head>
 								  <body>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								    <h1>Le contrôle de versions : RCS (<em>Revision Control System</em>)</h1>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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.
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</p>
-												Ajout d'un avertissement pour indiquer que le logiciel est vieux.

											
										
										
											2011-07-08 04:09:34 +02:00
+								<p>
 								Attention, ce logiciel est assez ancien et peu utilisé de nos jours.
 								Pour une utilisation personnelle à la manière de ce tutoriel, on utilise plus souvent <a href="../git/">git</a>.
 								</p>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								<h2><a name="base">Commandes de base</a></h2>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<h3><a name="ci">Enregistrer le fichier</a></h3>
 								<p> <code>ci</code> (de l'anglais <em>check-in</em>) est la
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								commande avec laquelle on dépose la dernière version du fichier dans l'archive
 								gérée par RCS.</p>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<span class="prompt">corvette ~ $</span> <em>ci monfichier </em>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								RCS/monfichier,v &lt;-- monfichier
 								initial revision: 1.1
 								enter description, terminated with ^D or '.':
 								NOTE: This is NOT the log message!
 								&gt;&gt;<em>Ceci est une description du fichier</em>
 								&gt;&gt; <em>.</em>
 								done
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<span class="prompt">corvette ~ $</span>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</pre>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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.
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</p>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								les versions de vos fichiers.
 								</p>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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).
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<h3><a name="co">Récupérer le fichier</a></h3>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								<p><code>co</code> (de l'anglais <em>check-out</em>) est la
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								commande avec lequel on récupère une version du fichier dans l'archive gérée
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								par RCS.</p>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Supposons que vous voulez sortir la toute dernière version de notre fichier,
 								appelé  <code>monfichier</code>. </p>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<span class="prompt">corvette ~ $</span> <em>co monfichier </em>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								RCS/monfichier,v --&gt; monfichier
 								revision 1.1
 								done
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<span class="prompt">corvette ~ $</span>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</pre>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								La version 1.1 de <code>monfichier</code> est rétablie dans le répertoire
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								courant.
 								</p>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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.
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								</p>
 								<h2><a name="faq">FAQ</a></h2>
 								<ul>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> <strong>Lisez bien les messages de RCS :</strong> s'il dit
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
 								writable monfichier exists; overwrite? [ny](n)
 								</pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> <strong>Vous ne voulez pas que le fichier soit effacé après le
 								dépôt</strong>. Il faut taper :
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
 								ci -u monfichier
 								</pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Le fichier contenant les dernières modifications est sauvegardé normalement,
 								et vous conservez dans votre répertoire le fichier dans son dernier
 								état.</li>
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> <strong>Vous voulez rétablir la version 1.4 et pas la plus
 								récente</strong>. Tapez :
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
 								co -r1.4 monfichier
 								</pre></li>
 								<li> <strong>Vous voulez un historique des versions</strong>, avec les
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								commentaires que vous aviez mis. Tapez :
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<pre>
 								rcslog monfichier
 								</pre></li>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> <strong>En quoi <code>monfichier</code> diffère-t-il actuellement de la version
 .3 ?</strong> Tapez :
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
 								<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">
-												Passage à git des « Dernière modif... »

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

											
										
										
											2009-09-27 22:00:55 +02:00
+								      Auteur : Roberto Dicosmo (1993?). <date value="from git" />
-												Ajout de la doc RCS

											
										
										
											2002-12-16 09:24:58 +01:00
+								    </div>
 								  </body>
 								</html>