Files
JIMRI/help/fr/html/doc/Technical/CVSFAQ.shtml
T
2026-06-17 14:00:51 +02:00

185 lines
9.8 KiB
Plaintext

<!DOCTYPE html>
<html lang="fr">
<!-- Updated by Blorec Herv&#233; 2013-09-25-->
<head>
<title>JMRI: CVS FAQ</title>
<meta name="author" content="Bob Jacobsen">
<meta name="keywords" content="JMRI technical code CVS FAQ">
<!--#include virtual="/help/fr/parts/Style.shtml" -->
</head>
<body>
<!--#include virtual="/help/fr/parts/Header_fr.shtml" -->
<div id="mBody">
<!--#include virtual="Sidebar.shtml" -->
<div id="mainContent">
<!-- Page Body -->
<h1>JMRI:Foire Aux Questions CVS (FAQ)</h1>
Ceci est une liste de questions fr&#233;quemment pos&#233;es sur CVS, en particulier sur la fa&#231;on dont nous l'utilisons avec JMRI.
<em> Note: Le code JMRI n'est plus maintenu dans CVS</em>
Pour obtenir le code actuel, veuillez consulter les pages
<a href="getgitcode.shtml">Acc&#232;s au code via le R&#233;pertoire Git</a>.
<a href="index.shtml"> Index Technique </a>
pour plus d'informations sur la maintenance du code JMRI.
<a name="cvstool"></a><h3>Comment puis-je obtenir une copie de CVS?</h3>
De nombreux ordinateurs sont livr&#233;s avec CVS install&#233;, y compris Linux et Mac OS X.
Si vous utilisez Windows, vous aurez besoin d'installer un programme CVS "client" comme
<a href="http://sourceforge.net/project/showfiles.php?group_id=10072&amp;release_id=24467"> WinCVS </a>.
Une version r&#233;cente peut &#234;tre t&#233;l&#233;charg&#233;e &#224; partir de:
<a href="http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip">WinCvs120.zip</a>.
<a name="jmrisource"></a>
<h3>Comment puis-je obtenir ma propre copie du code JMRI?</h3>
Pour obtenir une copie de la source pour votre propre usage, vous pouvez utiliser "checkout anonyme".
Pour un client en ligne de commande cvs, cr&#233;ez un nouveau r&#233;pertoire pour le projet,
allez dans ce r&#233;pertoire, et dites &#224; CVS que vous existez avec
<PRE>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri login
</pre>Ce "login " en ligne de connexion n'est n&eacute;cessaire
qu'une seule fois, apr&egrave;s quoi, il sera rappel&eacute; de
votre machine locale. On peut vous demander un mot de passe. Si
oui, appuyez simplement sur retour, sinon le mot de passe vide ne
sera pas accept&eacute;. Vous pouvez alors obtenir une copie du
code avec
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri co all
</pre>
<p>Si vous utilisez un client graphique comme WinCVS,
d&eacute;roulez le menu "admin" et s&eacute;lectionnez "ligne
de commande" pour obtenir une place pour taper ces commandes.
Sur d'autres ordinateurs, vous pouvez taper directement sur
la ligne de commande.</p>
<p>Pour plus d'information voir la page pour <a href=
"getcvscode.shtml">obtenir sa propre copie du code
source</a>.</p>
<a name="update" id="update"></a>
<h3>Comment puis-je mettre &agrave; jour ma copie du code
JMRI ?</h3>Les gens contribuent &agrave; la mises &agrave;
jour du code JMRI presque chaque semaine. Votre copie locale
ne re&ccedil;oit pas ces changements jusqu'&agrave; ce que
vous les demandiez, de sorte que vous avez quelque chose de
stable pour travailler avec. Si vous avez une copie existante
du code et que vous souhaitez mettre &agrave; jour avec le
contenu le plus r&eacute;cent de CVS, le commande CVS est:
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri -q update -dA
</pre>L'option "-q" supprime un grand nombre de messages de
routine. L'option "-d " est n&eacute;cessaire pour dire &agrave;
CVS d'apporter aussi de nouveaux r&eacute;pertoires. L'option "-A
", ici combin&eacute; avec "-d", signifie que vous voulez le
contenu le plus r&eacute;cent.
<a name="release" id="release"></a>
<h3>Comment puis-je obtenir le code pour une version
particuli&egrave;re?</h3>CVS utilise des
&laquo;balises&raquo; pour faire des ensembles de contenu
sp&eacute;cifique. Nous les utilisons pour marquer le code
pour chaque version que nous construisons. Pour obtenir le
code pour une version, vous pouvez la demander avec une
commande comme ceci:
<pre>
cvs -d:pserver:anonymous@jmri.cvs.sourceforge.net:/cvsroot/jmri -q co -rRelease-2-1-5
</pre><p>Dans cet exemple, "Release-2-1-5 " est le mot-cl&eacute; pour
la version 2.1.5. Vous pouvez ajuster le mot cl&eacute; au besoin.
Si vous avez d&eacute;j&agrave; une version v&eacute;rifi&eacute;e
et que vous souhaitiez mettre &agrave; jour une version
sp&eacute;cifique, changer le commandement "co" par "update-d"</p>
<h3><a name="refid" id="refid">Quelles sont ces lignes comme
<i>$Revision$</i> and <i>$Id$</i>?</a></h3>
<p>Elles sont
automatiquement mises &agrave; jour par CVS &agrave; chaque
fois qu'une nouvelle version du fichier est
v&eacute;rifi&eacute;, dans le r&eacute;f&eacute;rentiel.
S'il vous pla&icirc;t ne pas les modifier! Si vous contribuez
avec vos modifications au projet, ces lignes doivent
&ecirc;tre intactes dans le fichier de contribution.</p>
<h3>Comment puis-je mettre &agrave; jour une copie existante de
la source de la version actuelle?</h3>
Comme le code commun change, vous pouvez
mettre &agrave; jour votre copie pour contenir la
derni&egrave;re version. Pour ce faire, utilisez:
<code>
cvs -q update
</code>
Toute modification sera fusionn&#233;e dans les fichiers sur votre disque, et vous devriez &#234;tre &#224; jour avec vos propres modifications encore pr&#233;sentes.
<p>
L'option "-q" supprime un grand nombre de messages d'information pour CVS entre les diff&#233;rents r&#233;pertoires dans le projet, la commande fonctionne encore si vous l'omettez, mais il sera plus difficile de voir les messages d'erreur r&#233;elle.
<a name="ds_store"></a>
<h3>Quels sont ces messages sur .DS_Store files?</h3>
Si vous utilisez Mac OS X, CVS peut vous donner des messages &#224; propos de ". DS_Store ".Ils sont utilis&#233;s pour garder une trace de la disposition des fen&#234;tres, etc. Pour supprimer ces messages, il suffit de cr&#233;er un fichier dans votre r&#233;pertoire appel&#233; ". cvsignore" et ajouter une ligne
de ". DS_Store" (sans les guillemets). CVS va ignorer tous les . DS_Store dans tous les arbres extrait de votre r&#233;pertoire extrait.
<a name="tags"></a>
<h3>Quelle est la convention pour les noms d'&#233;tiquettes</h3>
En r&#232;gle g&#233;n&#233;rale, trois types de noms d'&#233;tiquettessont utilis&#233;s:
<ol>
<li> "Release-1-5-4" - la balise d&#233;finissant une version sp&#233;cifique du code publi&#233;.
Elles sont cr&#233;&#233;es lors de la lib&#233;ration de la version, et ne devrait pas &#234;tre chang&#233;es.
<li> "Release-1-5-4-branch" - c'est la branche-balise d&#233;finissant une "branche patch" pour une version
sp&#233;cifique. C'est la seule fois que nous font usage de branches CVS, s'il vous pla&#238;t noter que nous n'utilisons pas de branches pour le d&#233;veloppement normal.
<li> "rgj20050603a" - de la forme "initiales" "date" "quelque lettre", ne peut &#234;tre utilis&#233; que par des
d&#233;veloppeurs individuels pour garder une trace de ce qu'ils font. Tout ce que nous demandons, c'est que vous commenciez une &#233;tiquette avec vos initiales.
</ol>
<a name="structure"></a>
<h3>Comment JMRI est sauvegarder dans CVS?</h3>
JMRI se compose de deux grandes arborescences de code, et un certain nombre de r&#233;pertoires auxiliaires.
Le code est divis&#233; en "jmri", le code principal JMRI, et "test", l'ensemble des
tests est automatis&#233;s. Ils sont s&#233;par&#233;s de sorte qu'il est facile de construire tout
le logiciel distribu&#233;, sans y inclure le code de test.
(Si vous regardez directement le d&#233;p&#244;t CVS, vous verrez aussi les r&#233;pertoires "jmrit" et
"jmrix" , qui sont obsol&#232;tes, et conserv&#233;s exclusivement pour des raisons historiques).
<p>
De m&#234;me, l'information auxiliaire est gard&#233;s dans "lib", "xml",
"ressources", "jython", r&#233;pertoires, etc.
<p>
Enfin, il y a un tas d'informations qui ne font pas partie de la
zone de d&#233;veloppement d'applications, y compris le r&#233;pertoire des outils "scripts"
pour la lib&#233;ration des constructions, le site web, et d'autres.
<p>
Nous stockons tout ceci s&#233;par&#233;ment dans le CVS de sorte que vous pouvez v&#233;rifier uniquement celle dont vous avez besoin.
<p>
Pour simplifier l'extraction d'un arbre de d&#233;veloppement, nous offrons un module
CVS nomm&#233; "all". Cela v&#233;rifie les r&#233;pertoires n&#233;cessaires et les met
dans les endroits n&#233;cessaires pour construire en ligne droite.
<a name="lock"></a>
<h3>Certains fichiers semblent &#234;tre en lecture seule, pourquoi ceci?</h3>
Comme le logiciel &#233;volue, les fichiers deviennent parfois obsol&#232;tes.
S'ils ne sont pas tous n&#233;cessaires, CVS nous permet de les supprimer
des versions ult&#233;rieures. Dans ce cas, ils ne se montrent pas du tout lorsque vous v&#233;rifiez une copie &#224; jour.
<p>
Mais parfois, le fichier doit rester, mais nous voulons qu'il ne soit plus modifiable. Par exemple, un sch&#233;ma plus &#226;g&#233;s ou fichier DTD doit rester de telle sorte que les r&#233;f&#233;rences plus anciennes continuer &#224; travailler, mais nous ne voulons pas que quelqu'un puissent modifier accidentellement l'ancienne version au lieu de la version actuelle du fichier.
<p>
Dans de tels cas, nous utilisons le "cvs watch on " option pour
verrouiller efficacement le fichier. La version archiv&#233;e du fichier est prot&#233;g&#233;e en &#233;criture ainsi
vous ne pouvez pas le modifier sans
remarquer le probl&#232;me, et les changements ne peuvent pas &#234;tre v&#233;rifi&#233;es de nouveau dans CVS
&#224; moins que la montre de fichier soit d&#233;sactiv&#233;e.</p>
<!--#include virtual="/help/fr/parts/Footer_fr.shtml" -->
</div><!-- closes #mainContent-->
</div> <!-- closes #mBody-->
<script src="/js/help.js"></script>
</body>
</html>