[Kos-cvs] kos-web/contents cvsdoc_fr.i, 1.4, 1.5 cvsintro_en.i, 1.5, 1.6 cvsintro_fr.i, 1.6, 1.7

Thu Dec 30 01:35:53 CET 2004

Update of /var/cvs/kos/kos-web/contents
In directory the-doors:/tmp/cvs-serv14246/contents

Modified Files:
	cvsdoc_fr.i cvsintro_en.i cvsintro_fr.i 
Log Message:
Doc CVS

Index: cvsdoc_fr.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/cvsdoc_fr.i,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5

--- cvsdoc_fr.i	7 Sep 2003 14:55:49 -0000	1.4
+++ cvsdoc_fr.i	30 Dec 2004 00:35:51 -0000	1.5
@@ -5,147 +5,176 @@
 
 <i>Cette documentation vise à présenter les bases
 du développement avec cvs dans le cadre de kos.</i>
-<P>
-<H3>Généralités.</H3>
-<P><I>CVS, c'est quoi ?</I>
+<p>
+<h2>Généralités.</h2>
 
-<P>CVS (Concurrent Versions System) est un outil de gestion de
+<h3>CVS, c'est quoi ?</h3>
+
+<p>CVS (Concurrent Versions System) est un outil de gestion de
 versions. Il permet de tenir à jour l'historique de chacun des
 fichiers source d'un projet. Grâce à ce mécanisme, il est possible de
 récupérer n'importe quelle version d'un fichier source, de la
 modifier, et de reporter ces modifications sur les versions
 postérieures du projet. CVS s'occupe alors de gérer les éventuels
 conflits entre ces modifications et les évolutions qu'il aurait pu y
-avoir entre temps.
+avoir entre temps.</p>
 
 <p>Concernant KOS, un aspect de CVS est particulièrement
 intéressant. CVS gère le développement simultané du même projet par
 plusieurs utilisateurs éventuellement distants (CVS s'articule alors
 autour d'un serveur). Dans les cas extrèmes où les développements se
 recoupent (travail sur le même fichier source par exemple), CVS est
-capable de gérer les conflits.
+capable de gérer les conflits.</p>
 
-<P><I>Principes de CVS.</I>
+<h3>Principes de CVS.</h3>
 
-<P>CVS s'articule autour d'un dépôt unique centralisé (le Repository)
+<p>CVS s'articule autour d'un dépôt unique centralisé (le Repository)
 des sources du projet. Ce dépôt renferme, pour chaque fichier source,
 tout l'historique de l'évolution de ces sources. Pour kos, ce
 repository est localisé sur kos.enix.org. CVS vous permet d'y accéder
 à distance. Notons que ce repository peut renfermer les sources de
 plusieurs projets : chaque projet est un <i>module</i>, selon la
-terminologie CVS.
+terminologie CVS.</p>
 
-<P>En utilisation distante (cas de KOS), il y a plusieurs types
-d'accès à CVS :
-<UL>
-<LI>Lecture seule (ou anonyme). Les utilisateurs distants ne peuvent
+<p>En utilisation distante (cas de KOS), il y a plusieurs types
+d'accès à CVS :</p>
+
+<ul>
+<li>Lecture seule (ou anonyme). Les utilisateurs distants ne peuvent
 que se synchroniser avec la version courante des sources présentes sur
 le serveur. Ils ne peuvent pas modifier la version courante du
-repository;
+repository;</li>
 
-<LI>Lecture/écriture. L'utilisateur qui possède un tel droit peut
+<li>Lecture/écriture. L'utilisateur qui possède un tel droit peut
 synchroniser le repository avec sa version. Posséder ce droit autorise
 donc à modifier la version officielle des sources, à rajouter de
 nouveaux fichiers dans le repository, ou à en enlever. Ainsi, tous les
 utilisateurs qui se synchroniseront par la suite avec le repository
-pourront profiter des modifications qui ont pu être apportées.
-</UL>
+pourront profiter des modifications qui ont pu être apportées.</li>
 
-<P>Pour assigner les droits auxquels les utilisateurs ont droit, un
+</ul>
+
+<p>Pour assigner les droits auxquels les utilisateurs ont droit, un
 utilisateur est identifié par un login/mot de passe. Le processus
 d'authentification ne se fait qu'une et une seule fois, lors de
 l'initialisation de la copie de travail.  L'accès sera anonyme par
 défaut. Sauf pour les développeurs réguliers, qui seront chargés de
 centraliser, vérifier, et valider les patches fournis par les autres
-développeurs : ils se verront attribuer un accès en lecture/écriture.
+développeurs : ils se verront attribuer un accès en
+lecture/écriture.</p>
 
-<P><I>Utilisation de CVS pour KOS</I>
+<h3>Utilisation de CVS pour KOS</h3>
 
-<P>L'utilitaire cvs doit être invoqué avec, en paramètre, la commande
+<p>L'utilitaire cvs doit être invoqué avec, en paramètre, la commande
 qu'il doit effectuer. Nous donnons dans les paragraphes qui suivent
 les commandes essentielles nécessaires à la gestion de versions pour
 KOS. Pour une description détaillée et un tutoriel, reportez-vous à la
 documentation papier, ou à son équivalenent électronique : info cvs
-(sous UNIX). D'autres docs sont également disponibles
-sur <A HREF="http://www.cvshome.org/docs/index.html">http://www.cvshome.org/docs/index.html</A>.
+(sous UNIX). D'autres docs sont également disponibles sur <a
+href="http://www.cvshome.org/docs/index.html">http://www.cvshome.org/docs/index.html</a>.</p>
 
-<P><BR>
-<H3>Utilisation basique.</H3>
-<P><I>Initialiser sa copie de travail.</I>
-<P>Personne ne travaille directement sur le Repository du projet. Chaque utilisateur, et/ou chaque développeur doit commencer par créer sa propre copie du projet : la copie de travail.
-<P>Ceci se fait en 2 phases : 
-<UL>
-<LI>S'authentifier auprès du serveur : 
-<PRE>cvs -d <? echo $kos_pserver; ?> login</PRE>
-<P>Il vous sera demandé le mot de passe associé à l'utilisateur
-anonymous. Taper &lt;Entrée&gt;.
+<h2>Utilisation basique.</h2>
 
-<LI>Rapatrier les sources : 
-<PRE>mkdir kos<BR>cd kos<BR>cvs -z3 -d <? echo $kos_pserver; ?> checkout kos</PRE>
-</UL>
+<h3>Initialiser sa copie de travail.</h3>
 
-<P>Et voilà : dans kos/kos se trouve la dernière version du source de KOS. 
+<p>Personne ne travaille directement sur le Repository du
+projet. Chaque utilisateur, et/ou chaque développeur doit commencer
+par créer sa propre copie du projet : la copie de travail.</p>
 
-<P><H5>Note :</H5>
+<p>Ceci se fait en 2 phases : </p>
 
-<P>On n'initialise sa copie de travail qu'une seule fois. Même à 15
-ans d'intervalle, il n'est pas nécessaire de refaire les étapes
-précédentes.  <BR>Une fois qu'on a installé sa copie de travail, on
-n'y touche plus. On se contente de la tenir à jour (commande cvs
-update) et de mettre à jour le repository avec ses modifications
-(commande cvs commit quand on a le droit d'écriture).
+<ul>
 
-<BR><P><P><I>Se synchroniser avec le repository</I>
+ <li>
+   <p>S'authentifier auprès du serveur :</p>
+   <pre>
+cvs -d <? echo $kos_pserver; ?> login
+</pre>
+   <p>Il vous sera demandé le mot de passe associé à l'utilisateur
+anonymous. Taper &lt;Entrée&gt;.</p>
+ </li>
 
-<P>Pour que vos sources de KOS reflètent la dernière version
-disponible sur le repository, exécuter :
+ <li>
+   <p>Rapatrier les sources :</p>
+   <pre>
+mkdir kos
+cd kos
+cvs -z3 -d <? echo $kos_pserver; ?> checkout kos
+</pre>
+  </li>
 
-<PRE>cd kos/kos<BR>cvs -z3 update -dP</PRE>
+</ul>
 
-<P>Lorsque des modifications ont été faites sur la copie locale, et
+<p>Et voilà : dans kos/kos se trouve la dernière version du source de KOS.</p>
+
+<p><b>Note:</b> On n'initialise sa copie de travail qu'une seule
+fois. Même à 15 ans d'intervalle, il n'est pas nécessaire de refaire
+les étapes précédentes.</p>
+
+<p>Une fois qu'on a installé sa copie de travail, on n'y touche
+plus. On se contente de la tenir à jour (commande cvs update) et de
+mettre à jour le repository avec ses modifications (commande cvs
+commit quand on a le droit d'écriture).</p>
+
+<h3>Se synchroniser avec le repository</h3>
+
+<p>Pour que vos sources de KOS reflètent la dernière version
+disponible sur le repository, exécuter :</p>
+
+<pre>
+cd kos/kos
+cvs -z3 update -dP
+</pre>
+
+<p>Lorsque des modifications ont été faites sur la copie locale, et
 qu'elles viennent en conflit avec les modifications faites par
 quelqu'un d'autre sur la dernière version du repository, un conflit
 est signalé. Et on trouve des délimiteurs de ce conflit dans les
-sources (plein de <<<<, de ====, et de >>>>).
+sources (plein de <<<<, de ====, et de >>>>).</p>
 
-En général, ces conflits sont faciles a corriger. 
+<p>En général, ces conflits sont faciles a corriger.</p>
 
-<P>Il est conseillé de faire un update avant de se mettre a modifier
+<p>Il est conseillé de faire un update avant de se mettre a modifier
 le source de KOS, pour être sûr de ne pas faire quelque chose qui
-aurait déjà été fait.
+aurait déjà été fait.</p>
 
-<P>Les updates sont permis pour tout le monde (lecture seule comme
-lecture/écriture).
+<p>Les updates sont permis pour tout le monde (lecture seule comme
+lecture/écriture).</p>
 
-<A name="patch">
-<P><I>Constituer un patch</I>
+<a name="patch"></a>
 
-<P>Lorsqu'on n'a qu'un accès en lecture seule, et qu'on voudrait faire
+<h3>Constituer un patch</h3>
+
+<p>Lorsqu'on n'a qu'un accès en lecture seule, et qu'on voudrait faire
 intégrer des modifications qu'on a faites, il faut envoyer un patch à
 une personne qui possède les droits en écriture sur le cvs. On
 choisira d'envoyer son patch par mail à la personne responsable de la
-partie qu'on a modifiée (gestion mémoire,ordonnancement, fs...).
-<BR>Voila comment constituer un patch : 
-<PRE>cd kos/kos<BR>cvs diff -u > nom_du_patch.patch</PRE>
+partie qu'on a modifiée (gestion mémoire,ordonnancement, fs...).</p>
 
-<P>Sinon, lorsqu'on veut ajouter de nouveaux fichiers, les envoyer
+<p>Voila comment constituer un patch :</p>
+
+<pre>
+cd kos/kos
+cvs diff -u > nom_du_patch.patch
+</pre>
+
+<p>Sinon, lorsqu'on veut ajouter de nouveaux fichiers, les envoyer
 directement par mail au responsable. Lorsqu'on voudrait voir des
-fichiers supprimés, les signaler au responsable.
+fichiers supprimés, les signaler au responsable.</p>
 
-<P>Autres commandes diverses
-<UL>
-<LI>cvs log nom_fichier : donne l'historique des modifications
-associées à nom_fichier (qui peut être un répertoire);
+<p>Autres commandes diverses</p>
 
-<LI>cvs status nom_fichier : donne quelques informations concernant
-l'état de ce fichier dans le repository (version CVS, ...). Le
-commutateur -v peut-être d'un intérêt certain.
+<ul>
 
-</UL>
-<BR>
+ <li><code>cvs log nom_fichier</code> : donne l'historique des
+ modifications associées à nom_fichier (qui peut être un
+ répertoire);</li>
 
-<BR><P><BR>
-<P align=center><A HREF="mailto:d2 AT enix DOT org">d2 AT enix DOT org</A>
+ <li><code>cvs status nom_fichier</code> : donne quelques informations
+ concernant l'état de ce fichier dans le repository (version CVS,
+ ...). Le commutateur -v peut-être d'un intérêt certain.</li>
+
+</ul>
 
 <?
 end_content_section();

Index: cvsintro_en.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/cvsintro_en.i,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- cvsintro_en.i	7 Sep 2003 14:55:49 -0000	1.5
+++ cvsintro_en.i	30 Dec 2004 00:35:51 -0000	1.6
@@ -5,21 +5,23 @@
 
 
 <p>The CVS server of the <strong>KOS</strong> has been set up and is
-maintained by <a href="mailto:d2 AT enix DOT org">David Decotigny</a>.
+maintained by <a href="mailto:d2 AT enix DOT org">David
+Decotigny</a>.</p>
 
 <p>Anonymous access is allowed for everybody (see below). For
 developers, write access is available through SSH, and is restricted
-to authorized people.
+to authorized people.</p>
 
 <p>Nevertheless, you can have the last version of the sources and of
-the documentation (daily update) at <A
-Href="snapshots.php?lang=en">snapshots</A>.
+the documentation (daily update) at <a
+Href="snapshots.php?lang=en">snapshots</a>.</p>
 
 <p>
 The patches are to be sent via mail to <a
 href="mailto:thomas DOT petazzoni AT enix DOT org">Thomas</A>, <a
 href="mailto:julien DOT munier at enix DOT org">Julien</a>, or <a
-href="mailto:d2 AT enix DOT org">moi-même</a> (<tt>cvs diff -u | mail</tt>).
+href="mailto:d2 AT enix DOT org">moi-même</a> (<tt>cvs diff -u |
+mail</tt>).</p>
 
 <?
 end_content_section();

Index: cvsintro_fr.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/cvsintro_fr.i,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- cvsintro_fr.i	7 Sep 2003 14:55:49 -0000	1.6
+++ cvsintro_fr.i	30 Dec 2004 00:35:51 -0000	1.7
@@ -3,25 +3,21 @@
 include("$topsrcdir/include/site.php");
 ?>
 
-<p>
-Le serveur CVS de <strong>KOS</strong> est maintenu par <a
-href="mailto:d2 AT enix DOT org">David Decotigny</a>.
+<p>Le serveur CVS de <strong>KOS</strong> est maintenu par <a
+href="mailto:d2 AT enix DOT org">David Decotigny</a>.</p>
 
-<p>
-L'accès <i>anonyme</i> est ouvert a tout le monde (voir
+<p>L'accès <i>anonyme</i> est ouvert a tout le monde (voir
 ci-dessous). Pour les développeurs autorisés, l'accès en
-lecture/écriture se fait via SSH.
+lecture/écriture se fait via SSH.</p>
 
-<p>
-Vous pouvez également récupérer la derniere version des sources et des
-docs (mise a jour quotidienne) en allant sur la page des <A
-Href="snapshots.php?lang=fr">snapshots</A>.
+<p>Vous pouvez également récupérer la derniere version des sources et
+des docs (mise a jour quotidienne) en allant sur la page des <a
+Href="snapshots.php?lang=fr">snapshots</a>.</p>
 
-<p>
-Les patches (voir <a href="#patch">là</a>) sont à envoyer à <a
+<p>Les patches (voir <a href="#patch">là</a>) sont à envoyer à <a
 href="mailto:thomas DOT petazzoni AT enix DOT org">Thomas</A>, <a
 href="mailto:julien DOT munier AT enix DOT org">Julien</a>, ou <a
-href="mailto:d2 AT enix DOT org">moi-même</a> (<tt>cvs diff -u | mail</tt>).
+href="mailto:d2 AT enix DOT org">moi-même</a> (<tt>cvs diff -u | mail</tt>).</p>
 
 <?
   end_content_section();

