Some small changes
This commit is contained in:
martignoni
+18
-18
@@ -18,7 +18,7 @@
|
||||
CVS est un acronyme pour désigner le « <strong>Concurrent Versioning System</strong> », une façon pratique et très répandue de stoquer le code source de projets informatiques. Un CVS conserve toutes les versions de tous les fichiers, de sorte qu'aucune donnée n'est jamais perdue, et que les traces de l'utilisation par les différentes personnes sont conservées. Le système offre en outre la possibilité de fusionner le code si plusieurs personnes travaillent sur un même fichier. Tout le code et toutes les versions sont enregistrées sur un serveur central (dans le cas de Moodle, sur <a target="_top" href="http://www.sf.net/">Sourceforge</a>).
|
||||
</p>
|
||||
<p>
|
||||
Si vous désirez simplement télécharger par CVS la version actuelle de Moodle pour lancer un site, vous n'avez pas besoin de cette page. Il vous suffit de suivre les instructions (plus simples) pour télécharger Moodel par CVS sur la page <a target="_top" href="http://moodle.org/download">Téléchargement de Moodle</a>.
|
||||
Si vous désirez simplement télécharger par CVS la version actuelle de Moodle pour lancer un site, vous n'avez pas besoin de cette page. Il vous suffit de suivre les instructions (plus simples) pour télécharger Moodle par CVS sur la page <a target="_top" href="http://moodle.org/download">Téléchargement de Moodle</a>.
|
||||
</p>
|
||||
|
||||
<h2><a name="1"></a>Thèmes de ce document</h2>
|
||||
@@ -159,7 +159,7 @@ cvs commit</div>
|
||||
<ol>
|
||||
<ol>
|
||||
<li>Cliquez avec le bouton droit de la souris sur votre dossier Moodle (ou sur n'importe quel fichier) et sélectionnez « <strong>CVS Update</strong> ».</li>
|
||||
<li>Attendez et voyez défiler les fichiers de jounalisation. Prenez note des conflits pouvant survenir si votre code local a des modifications en contradiction avec les versions téléchargées. Vous aurez à résoudre manuellement ces fichiers en les modifiant.
|
||||
<li>Attendez et voyez défiler les historiques (logs). Prenez note des conflits pouvant survenir si votre code local a des modifications en contradiction avec les versions téléchargées. Vous aurez à résoudre manuellement ces fichiers en les modifiant.
|
||||
</ol>
|
||||
</ol>
|
||||
<blockquote>
|
||||
@@ -184,7 +184,7 @@ cvs commit</div>
|
||||
<div class="commandline">cvs status -v index.php</div>
|
||||
<p>Quelques recommandations au sujet des balises :</p>
|
||||
<ul>
|
||||
<li>Les balises et les noms des branches doivent toujours être en lettre capitales.</li>
|
||||
<li>Les balises et les noms des branches doivent toujours être en lettres capitales.</li>
|
||||
<li>Les balises et les noms des branches doivent TOUJOURS être appliqués sur <strong>l'intégralité du module</strong> (la totalité de Moodle). N'appliquez pas de balises à des fichiers individuels ou à des dossiers.</li>
|
||||
<li>Il n'est pas autorisé de changer le nom des balises, car des développeurs comptent dessus ! Tapez-les donc correctement du premier coup.</li>
|
||||
</ul>
|
||||
@@ -194,7 +194,7 @@ cvs commit</div>
|
||||
<p>Dans le jargon CVS, le <strong>tronc</strong> (trunk) est la version principale en développement de Moodle. Elle est aussi appelée <span class="style4">HEAD</span>, ou encore branche par défaut.</p>
|
||||
<p>Les développeurs de Moodle font en sorte que le tronc reste aussi stable que possible, mais il contient d'habitude du nouveau code, avec des bogues et de petites instabilités.</p>
|
||||
<p>De temps à autre, nous décidons que le produit possède suffisamment de fonctionnalités pour sortir une version. Le tronc reçoit alors une balise MOODLE_XX_BETA (pour le cas où l'on devrait revenir à ce point) et une nouvelle branche du nom de <span class="style1">MOODLE_XX_STABLE</span> est créée pour la nouvelle version.</p>
|
||||
<p>Une version bêta est aussi publiée à ce point. Elle est destinée aux testeurs qui n'utilisient pas CVS mais désirent essayer les dernières fonctionnalités et en rapporter les bogues.</p>
|
||||
<p>Une version bêta est aussi publiée à ce point. Elle est destinée aux testeurs qui n'utilisent pas CVS mais désirent essayer les dernières fonctionnalités et en rapporter les bogues.</p>
|
||||
</blockquote>
|
||||
|
||||
|
||||
@@ -202,13 +202,13 @@ cvs commit</div>
|
||||
<h3><a name="4.2" id="4.2"></a>4.2 Branches stables pour chaque version</h3>
|
||||
<blockquote>
|
||||
<p>Dès que la branche stable <span class="style3">MOODLE_XX_STABLE</span> est créée, les efforts de développement se divisent temporairement en deux. Certains développeurs continuent à travailler sur de nouvelles fonctionnalités du tronc pour les prochaines versions, mais la plupart d'entre eux se concentrent sur la branche <span class="style1"><strong>STABLE</strong></span> actuelle et corrigent les bogues qui y sont découverts.</p>
|
||||
<p>Vous pouvez faire en sorte que votre copie locale de Moodle soit en synchronisation avec la version STABLE en tapant la commande unix suivante depuis le dossier principale de Moodle :</p>
|
||||
<p>Vous pouvez faire en sorte que votre copie locale de Moodle soit en synchronisation avec la version STABLE en tapant la commande unix suivante depuis le dossier principal de Moodle :</p>
|
||||
<div class="commandline">cvs update -dP -r <span class="style1">MOODLE_XX_STABLE</span></div>
|
||||
<p>À la suite de cela, toutes les commandes décrites ci-dessus s'appliqueront à la version stable. Pour revenir au tronc, tapez simplement :</p>
|
||||
<div class="commandline">cvs update -dPA</div>
|
||||
<p>Sous Windows, un menu devrait être disponible où vous pouvez choisir la branche.</p>
|
||||
<p>Lorsque la nouvelle branche STABLE se stabilise véritablement, une version est publiée. Les fichiers compressés sont créés pour la distribution et la branche reçoit de Martin une balise du nom de <strong>MOODLE_XXX</strong>.</p>
|
||||
<p>Périodiquement, les corrections de bogues de la branche STABLE doivent être incorporés dans le tronc afin qu'elles soient aussi disponibles dans les futures versions de Moodle. Une balise mobile appelée MOODLE_XX_MERGED sera maintenue pour garder une trace de la dernière incorporation. La procédure pour une telle incorporation se passe ainsi :</p>
|
||||
<p>Périodiquement, les corrections de bogues de la branche STABLE doivent être incorporées dans le tronc afin qu'elles soient aussi disponibles dans les futures versions de Moodle. Une balise mobile appelée MOODLE_XX_MERGED sera maintenue pour garder une trace de la dernière incorporation. La procédure pour une telle incorporation se passe ainsi :</p>
|
||||
<ol>
|
||||
<li>Télécharger la toute dernière version du tronc :<br /><br />
|
||||
<div class="commandline">cvs update -dPA<span> </span></div>
|
||||
@@ -216,35 +216,35 @@ cvs commit</div>
|
||||
<li>Incorporer dans le tronc toutes les modifications de la branche effectuées depuis la dernière incorporation :<br /><br />
|
||||
<div class="commandline">cvs update -kk -j MOODLE_XX_MERGED -j MOODLE_XX_STABLE<span> </span></div>
|
||||
</li>
|
||||
<li>Lire attentivement les journaux d'activité (logs) à la recherche d'éventuels conflits et corriger tous les fichiers avec ces conflits ;
|
||||
<li>Lire attentivement les historiques (logs) à la recherche d'éventuels conflits et corriger tous les fichiers concernés par ces conflits ;
|
||||
</li>
|
||||
<li>Appliquer la copie modifiée dans le tronc du CVS :<br /><br />
|
||||
<div class="commandline">cvs commit<span> </span></div>
|
||||
</li>
|
||||
<li>Revenir à la branche stable<br /><br />
|
||||
<li>Revenir à la branche stable ;<br /><br />
|
||||
<div class="commandline">cvs update -dPr MOODLE_XX_STABLE<span> </span></div>
|
||||
</li>
|
||||
<li>Mettre à jour la balise mobile d'incorporation fin que la procédure puisse être répétée la prochaine fois :<br /><br />
|
||||
<li>Mettre à jour la balise mobile d'incorporation afin que la procédure puisse être répétée la prochaine fois :<br /><br />
|
||||
<div class="commandline">cvs tag -RF MOODLE_XX_MERGED<span> </span></div>
|
||||
</li>
|
||||
</ol><br />
|
||||
<p>Enfin, les valeurs des variables <strong>$version</strong> de tous les fichiers « version.php » de Moodle de la branche stable ne doivent pas être mis à jour si possible (à part le dernier chiffre si nécessaire). La raison en est que si quelqu'un faut une mise à jour d'une version très stable à la version très stable suivante, il pourrait sans cela manquer une mise à jour arrivée sur le tronc.</p>
|
||||
</ol>
|
||||
<p>Enfin, les valeurs des variables <strong>$version</strong> de tous les fichiers « version.php » de Moodle de la branche stable ne doivent pas être mis à jour si possible (à part le dernier chiffre si nécessaire). La raison en est que si quelqu'un fait une mise à jour d'une version très stable à la version très stable suivante, il pourrait sans cela manquer une mise à jour arrivée sur le tronc.</p>
|
||||
</blockquote>
|
||||
<p> </p>
|
||||
<h3><a name="4.3" id="4.3"></a>4.3 Branches particulières pour tout changement important</h3>
|
||||
<blockquote>
|
||||
<p>Occasionnellement, il est nécessaire d'incorporer une nouvelle fonctionnalité afin que plusieurs développeurs puissent y travailler ensemble, même si elle est encore instable pour être incorporée dans le tronc.</p>
|
||||
<p>Dans ces cas, une branche temporaire est créée pour travailler sur la focntionnalité, puis incorporée au tronc principal dès que possible. Un exemple de branche appelée <span class="style1"><strong>MOODLE_14_WIDGET</strong></span> peut être vu sur le diagramme ci-dessus.</p>
|
||||
<p>si vous avez besoin de cela pour votre fonctionnalité WIDGET, suivez ces instructions :</p>
|
||||
<p>Occasionnellement, il est nécessaire d'incorporer une nouvelle fonctionnalité afin que plusieurs développeurs puissent y travailler ensemble, même si elle est encore trop instable pour être incorporée dans le tronc.</p>
|
||||
<p>Dans ces cas, une branche temporaire est créée pour travailler sur la fonctionnalité, puis incorporée au tronc principal dès que possible. Un exemple de branche appelée <span class="style1"><strong>MOODLE_14_WIDGET</strong></span> peut être vu sur le diagramme ci-dessus.</p>
|
||||
<p>Si vous avez besoin de cela pour votre fonctionnalité WIDGET, suivez ces instructions :</p>
|
||||
<ol>
|
||||
<li>Discutez avec les autres développeurs pour vous assurer que c'est vraiment nécessaire !</li>
|
||||
<li>Créez une nouvelle balise sur le <strong>tronc</strong> (pour la totalité de moodle) avec le nom <strong>MOODLE_XX_WIDGET_PRE</strong><br /><br />
|
||||
<div class="commandline">cvs tag -R MOODLE_XX_WIDGET_PRE<span> </span></div></li>
|
||||
<li>Crréez votre nouvelle branche avec le nom <span class="style1"><strong>MOODLE_XX_WIDGET</strong></span><br /><br />
|
||||
<li>Créez votre nouvelle branche avec le nom <span class="style1"><strong>MOODLE_XX_WIDGET</strong></span><br /><br />
|
||||
<div class="commandline">cvs tag -Rb <span class="style1">MOODLE_XX_WIDGET</span></strong></div></li>
|
||||
<li>Travaillez dans cette branche jusqu'à ce que la fonctionnalité soit raisonnablement stable. Copier vos fichiers dans le CVS suivant vos besoins.<br /><br />
|
||||
<li>Travaillez dans cette branche jusqu'à ce que la fonctionnalité soit raisonnablement stable. Copiez vos fichiers dans le CVS suivant vos besoins.<br /><br />
|
||||
<div class="commandline">cvs commit<span> </span></div></li>
|
||||
<li>Lorsque vous êtes prêt, incorporez toute la branche dans le tronc, copier tous ses fichiers dans le tronc et abandonnez la branche.<br /><br />
|
||||
<li>Lorsque vous êtes prêt, incorporez toute la branche dans le tronc : copiez tous ses fichiers dans le tronc et abandonnez la branche.<br /><br />
|
||||
<div class="commandline">cvs update -dPA<br />
|
||||
cvs update -kk -j <span class="style1">MOODLE_XX_WIDGET</span><br />
|
||||
cvs commit</div>
|
||||
@@ -255,7 +255,7 @@ cvs commit</div>
|
||||
</blockquote>
|
||||
|
||||
<p align="center">
|
||||
Bonne chance, soyez prudent et amusez-vous !
|
||||
Bonne chance, soyez prudent et amusez-vous bien !
|
||||
</p>
|
||||
<p> </p>
|
||||
</blockquote>
|
||||
|
||||
Reference in New Issue
Block a user