Bap: Makefile pour CVS

logiciels/cvs/index.tml

@@ -154,6 +154,18 @@ Maintenant, vous avez un r
 stocker les différents projets. Il ne reste plus qu'à le remplir !
 </p>
 
+<p>
+Plusieurs fois, <strong>cvs ouvrira un éditeur de texte</strong> en vous
+demandant de commenter ce que vous êtes en train de
+faire. <strong>Commentez vos modifications d'une avec un peu de
+précision</strong>&nbsp;: évitez par exemple d'écrire simplement
+«&nbsp;modifications diverses&nbsp;», mais plutôt «&nbsp;orthographe,
+typographie, paragraphe sur&nbsp;X ou&nbsp;Y, fontion&nbsp;Z ou&nbsp;T,
+etc.&nbsp;» L'objectif est qu'un autre contributeur (ou vous-même à une
+date ultérieure) puisse ne lire <em>que</em> ce commentaire et savoir la
+nature de vos modifications.
+</p>
+
 
 <h3>Créer un projet</h3>
 
@@ -371,6 +383,12 @@ fichiers&nbsp;:
 <span class="prompt">bireme ~/turing-test $</span> cvs commit <em>fichier1 fichier2 etc</em>
 </pre>
 
+<p>
+Quand vous partagez vos modifications, un éditeur de texte s'ouvre et
+vous demande de les commenter. Vous n'êtes pas obligé d'être bavard,
+mais soyez relativement précis.
+</p>
+
 
 <h3>Nettoyer son répertoire de travail</h3>
 
@@ -471,6 +489,71 @@ ant
 <span class="prompt">bireme ~/turing-test $</span> cvs commit fichier
 </pre>
 
+<h3>Astuce&nbsp;: utiliser l'outil <code>make</code></h3>
+
+<p>
+Imaginons la situation suivante&nbsp;: vous avez un site web sur lequel
+vous voulez travailler à l'aide de CVS. Vous avez donc un répertoire de
+dépôt (par exemple <code>~/cvs/www</code>) et un répertoire de travail
+(par exemple <code>~/cvs-travail/www</code>). Mais vous voulez aussi
+mettre à jour le site en lui-même lorsque vous partagez des
+modifications, et ce site est dans le répertoire <code>~/www</code>. Ce
+répertoire ne peut pas être le même que pour le dépôt, car celui-ci
+doit lui être exclusivement consacré&nbsp;; et il ne peut pas non plus
+être votre répertoire de travail, car la moindre modification (et
+surtout la moindre erreur) serait immédiatement publiée...
+</p>
+
+<p>
+Vous devrez donc taper, à chaque fois que vous voudrez partager vos
+modifications, les lignes suivantes&nbsp;:
+</p>
+
+<pre>
+<span class="prompt">bireme ~/cvs-travail/www $</span> cvs commit
+<span class="prompt">bireme ~/cvs-travail/www $</span> cvs update -d ~/www
+</pre>
+
+<p class="continue">
+Le problème, c'est que cette séquence de commandes sera toujours la même
+et que vous risquerez toujours d'en oublier une sur les deux... Aussi
+avez-vous la possibilité d'utiliser l'utilitaire <code>make</code>,
+outil très puissant, notamment dans ces circonstances (il est très
+utilisé par les programmeurs).
+</p>
+
+<p>
+Commencez donc par <strong>éditer un fichier Makefile</strong> dans le répertoire souche
+de votre projet dans le répertoire de travail&nbsp;; dans notre exemple,
+il s'agit de ~/cvs-travail/www. Dans ce fichier, écrivez&nbsp;:
+</p>
+
+<pre>
+install:
+        cvs commit
+        cvs update -d /users/<em>ma_promo</em>/<em>ma_section</em>/<em>mon_login</em>/www
+</pre>
+
+<p>
+Ensuite, ajoutez ce fichier Makefile au CVS&nbsp;:
+</p>
+
+<pre>
+<span class="prompt">bireme ~/cvs-travail/www $</span> cvs add Makefile
+</pre>
+
+<p>
+Et à partir de maintenant, au lieu de taper <code>cvs&nbsp;commit</code>
+pour partager vos modifications, vous taperez simplement&nbsp;:
+</p>
+
+<pre>
+<span class="prompt">bireme ~/cvs-travail/www $</span> make install
+</pre>
+
+<p class="continue">
+et <code>make</code> se chargera de tout à votre place&nbsp;! 
+</p>
 
 <p>
 Vous êtes maintenant prêt à utiliser CVS. Sa puissance est telle que cet
@@ -494,7 +577,7 @@ href="http://www.cvshome.org/docs/manual/">l
 
     <div class="metainformation">
       Auteurs : Baptiste Mélès, Joël Riou. Dernière modification le
-    <date value="$Date: 2005-09-16 08:06:05 $" />.
+    <date value="$Date: 2005-09-16 08:42:45 $" />.
     </div>
 
   </body>