hgbook

changeset 1006:c859c8d32838

french: small corrections on ch03
author William Dodé <wilk@flibuste.net>
date Tue Sep 15 13:40:45 2009 +0200 (2009-09-15)
parents 0d743c1cf101
children f4f740bb58be
files fr/ch03-tour-merge.xml
line diff
     1.1 --- a/fr/ch03-tour-merge.xml	Tue Sep 15 12:42:52 2009 +0200
     1.2 +++ b/fr/ch03-tour-merge.xml	Tue Sep 15 13:40:45 2009 +0200
     1.3 @@ -2,7 +2,7 @@
     1.4  
     1.5  <chapter id="chap:tour-merge">
     1.6    <?dbhtml filename="a-tour-of-mercurial-merging-work.html"?>
     1.7 -  <title>Un rapide tour de Mercurial: fusionner les travaux</title>
     1.8 +  <title>Un tour rapide de Mercurial : fusionner les travaux</title>
     1.9    
    1.10    <para id="x_338">Nous avons maintenant étudié comment cloner un dépôt, effectuer
    1.11      des changements dedans, et récupérer ou transférer depuis un
    1.12 @@ -11,8 +11,8 @@
    1.13  
    1.14    <sect1>
    1.15      <title>Fusionner différents travaux</title>
    1.16 -      <para id="x_339">La fusion  est un aspect fondamental lorsqu'on
    1.17 -      travaille iavec un gestionnaire de source distribué.</para>
    1.18 +      <para id="x_339">La fusion est un aspect fondamental lorsqu'on
    1.19 +      travaille avec un gestionnaire de révisions distribué.</para>
    1.20  
    1.21        <itemizedlist>
    1.22          <listitem>
    1.23 @@ -45,13 +45,13 @@
    1.24  
    1.25        &interaction.tour.merge.cat1;
    1.26       
    1.27 -     <para id="x_722">Et ici est notre légèrement différente version du
    1.28 +     <para id="x_722">Et ici se trouve notre version légèrement différente du
    1.29         dépôt.</para>
    1.30       
    1.31        &interaction.tour.merge.cat2;
    1.32       
    1.33       <figure id="fig:tour-merge:sep-repos">
    1.34 -       <title>Historique divergent des dépôts <filename
    1.35 +       <title>Historique divergeant des dépôts <filename
    1.36           class="directory">my-hello</filename> et <filename
    1.37           class="directory">my-new-hello</filename>.</title>
    1.38         <mediaobject>
    1.39 @@ -71,18 +71,18 @@
    1.40         <quote>heads</quote>.</para>
    1.41  
    1.42       <sect2>
    1.43 -       <title>Les révisions 'heads'</title>
    1.44 +         <title>Les révisions <quote>heads</quote></title>
    1.45  
    1.46         <para id="x_341">Rappellez vous que Mercurial enregistre quelle révision
    1.47           est le parent de chaque révision. Si une révision a un parent, nous
    1.48 -         l'appelons un enfant(child) ou un descendant de ce parent. Une
    1.49 -         "head" est une révision qui n'a donc pas d'enfant. La révision tip
    1.50 -         est donc une "head", car c'est la révision la plus récente du dépôt
    1.51 +         l'appelons un enfant <quote>child</quote> ou un descendant de ce parent. Une
    1.52 +         <quote>head</quote> est une révision qui n'a donc pas d'enfant. La révision <quote>tip</quote>
    1.53 +         est donc une <quote>head</quote>, car c'est la révision la plus récente du dépôt
    1.54           qui n'a pas d'enfant. Il y a des moments où un dépôt peut contenir
    1.55 -         plusieurs "head".</para>
    1.56 +         plusieurs <quote>heads</quote>.</para>
    1.57  
    1.58         <figure id="fig:tour-merge:pull">
    1.59 -         <title>Contenu du dépôt après une récupération ("pull") depuis le
    1.60 +           <title>Contenu du dépôt après une récupération (pull) depuis le
    1.61             dépôt <filename
    1.62             class="directory">my-hello</filename> vers le dépôt <filename
    1.63             class="directory">my-new-hello</filename></title>
    1.64 @@ -95,18 +95,18 @@
    1.65         </figure>
    1.66  
    1.67         <para id="x_343">Dans la figure <xref linkend="fig:tour-merge:pull"/>,
    1.68 -         vous pouvez constater l'effet d'un \textit{pull} depuis le dépôt
    1.69 +           vous pouvez constater l'effet d'un <quote>pull</quote> depuis le dépôt
    1.70           <filename class="directory">my-hello</filename> dans le dépôt
    1.71           <filename class="directory">my-new-hello</filename>. L'historique qui
    1.72           était déjà présent dans le dépôt <filename
    1.73           class="directory">my-new-hello</filename> reste intact, mais une
    1.74           nouvelle révision a été ajoutée. En vous reportant à la figure <xref
    1.75           linkend="fig:tour-merge:sep-repos"/>, vous pouvez voir que le
    1.76 -         <emphasis>ID de révision (changeset ID)</emphasis> reste le même dans
    1.77 +     <emphasis>ID de révision <quote>changeset ID</quote></emphasis> reste le même dans
    1.78           le nouveau dépôt, mais que le <emphasis>numéro de
    1.79           révision</emphasis> reste le même. (Ceci est un parfait exemple de
    1.80           pourquoi il n'est fiable d'utiliser les numéros de révision lorsque
    1.81 -         l'on discute d'un \textit{changeset}.) Vous pouvez voir les "heads"
    1.82 +         l'on discute d'un <quote>changeset</quote>.) Vous pouvez voir les <quote>heads</quote>
    1.83           présentes dans le dépôt en utilisant la commande <command
    1.84           role="hg-cmd">hg heads</command>.</para>
    1.85  
    1.86 @@ -118,7 +118,7 @@
    1.87  
    1.88          <para id="x_344">Que se passe-t-il quand vous essayez d'utiliser la
    1.89            commande <command role="hg-cmd">hg update</command> pour mettre à
    1.90 -          jour votre espace de travail au nouveau "tip"</para>
    1.91 +          jour votre espace de travail au nouveau <quote>tip</quote></para>
    1.92           
    1.93           &interaction.tour.merge.update;
    1.94  
    1.95 @@ -129,9 +129,9 @@
    1.96            estime que nous pourrions avoir besoin d'une fusion, à moins de lui
    1.97            forcer la main. À la place, il faut utiliser la commande <command
    1.98            role="hg-cmd">hg merge</command> pour fusionner les deux
    1.99 -          "heads".</para>
   1.100 -
   1.101 -       <para id="x_723">Pour commencer une fusion (merge) entre deux "heads",
   1.102 +          <quote>heads</quote>.</para>
   1.103 +
   1.104 +       <para id="x_723">Pour commencer une fusion (merge) entre deux <quote>heads</quote>,
   1.105         nous utilisons la commande <command role="hg-cmd">hg merge</command>.</para>
   1.106  
   1.107          &interaction.tour.merge.merge; 
   1.108 @@ -139,7 +139,7 @@
   1.109         <para id="x_347">Nous résolvons les conflits dans le fichier
   1.110           <filename>hello.c</filename>. Ceci met à jour le répertoire de travail
   1.111           de sorte qu'il ne contienne les modifications ne provenance des
   1.112 -         <emphasis>deux</emphasis> "heads", ce qui est indiqué par la
   1.113 +         <emphasis>deux</emphasis> <quote>heads</quote>, ce qui est indiqué par la
   1.114           la sortie de la commande <command role="hg-cmd">hg
   1.115           parents</command> et le contenu du fichier
   1.116           <filename>hello.c</filename>.</para>
   1.117 @@ -159,7 +159,7 @@
   1.118          &interaction.tour.merge.commit;
   1.119  
   1.120        <para id="x_349">Nous avons maintenant un nouveau tip, remarquer qu'il
   1.121 -        contient <emphasis>à la fois</emphasis> nos anciennes "heads" et leurs
   1.122 +        contient <emphasis>à la fois</emphasis> nos anciennes <quote>heads</quote> et leurs
   1.123          parents. Ce sont les mêmes révisions que nous avions affichées avec
   1.124          la commande <command role="hg-cmd">hg parents</command>.</para>
   1.125  
   1.126 @@ -168,13 +168,13 @@
   1.127        <para id="x_34a">Dans la figure <xref linkend="fig:tour-merge:merge"/>,
   1.128          vous pouvez voir une représentation de ce qui se passe dans l'espace
   1.129          de travail pendant la fusion, et comment ceci affecte le dépôt lors
   1.130 -        du "commit". Pendant la fusion, l'espace de travail, qui a deux
   1.131 +        du <quote>commit</quote>. Pendant la fusion, l'espace de travail, qui a deux
   1.132          révisions (changesets) comme parents, voit ces derniers devenir le parent
   1.133          d'une nouvelle révision (changeset).</para>
   1.134  
   1.135        <figure id="fig:tour-merge:merge">
   1.136 -        <title>Working directory and repository during merge, and
   1.137 -          following commit</title>
   1.138 +          <title>Répertoire de travail et dépôt pendant une fusion, 
   1.139 +              et le <quote>commit</quote> qui suit</title>
   1.140          <mediaobject>
   1.141            <imageobject>
   1.142              <imagedata fileref="figs/tour-merge-merge.png"/>
   1.143 @@ -189,12 +189,12 @@
   1.144    <sect1>
   1.145      <title>Fusionner les modifications en conflit</title>
   1.146  
   1.147 -    <para id="x_34b">La plupart des fusions sont assez simple à réaliser, mais 
   1.148 +    <para id="x_34b">La plupart des fusions sont assez simples à réaliser, mais 
   1.149        parfois vous vous retrouverez à fusionner des fichiers où la modification 
   1.150        touche la même portion de code, au sein d'un même fichier. À moins 
   1.151        que ces modification ne soient identiques, ceci aboutira à un 
   1.152        <emphasis>conflit</emphasis>, et vous devrez décider comment réconcilier 
   1.153 -      les différentes modifications dans un tout cohérent.</para>
   1.154 +      les différentes modifications dans un ensemble cohérent.</para>
   1.155  
   1.156      <figure id="fig:tour-merge:conflict">
   1.157        <title>Modifications en conflits dans un document</title>
   1.158 @@ -214,12 +214,12 @@
   1.159      <para id="x_34e">Mercurial n'a pas de mécanisme interne pour gérer 
   1.160        les conflits. À la place, il exécute un programme externe appelé 
   1.161        <command>hgmerge</command>. Il s'agit d'un script shell qui est 
   1.162 -      embarqué par Mercurial, vous pouvez le modifier si vous le voulez. 
   1.163 +      compris avec Mercurial, vous pouvez le modifier si vous voulez. 
   1.164        Ce qu'il fait par défaut est d'essayer de trouver un des différents 
   1.165        outils de fusion qui seront probablement installés sur le système. 
   1.166 -      Il commence par les outils totalement automatiques, et si ils 
   1.167 +      Il commence par les outils totalement automatiques, et s'ils 
   1.168        échouent (parce que la résolution du conflit nécessite une
   1.169 -      intervention humaine) ou si ils sont absents, le script tente
   1.170 +      intervention humaine) ou s'ils sont absents, le script tente
   1.171        d'exécuter certains outils graphiques de fusion.</para>
   1.172  
   1.173      <para id="x_34f">Il est aussi possible de demander à Mercurial d'exécuter
   1.174 @@ -235,22 +235,22 @@
   1.175          fonctionnalités classiques des outils graphiques de fusion. Vous pouvez
   1.176          voir une capture d'écran de l'utilisation de <command>kdiff3</command>
   1.177          dans la figure <xref linkend="fig:tour-merge:kdiff3"/>. Cet outil
   1.178 -        effectue une <emphasis>fusion \textit{three-way</emphasis>}, car il y a
   1.179 -        trois différentes versions du fichier qui nous intéresse. Le fichier
   1.180 -        découpe la partie supérieure de la fenêtre en trois panneaux:</para>
   1.181 +        effectue une <emphasis>fusion <quote>three-way</quote></emphasis>, car il y a
   1.182 +        trois différentes versions du fichier qui nous intéressent. Le fichier
   1.183 +        découpe la partie supérieure de la fenêtre en trois panneaux :</para>
   1.184        <itemizedlist>
   1.185 -        <listitem><para id="x_351">A gauche on la version de
   1.186 +        <listitem><para id="x_351">À gauche on trouve la version de
   1.187            <emphasis>base</emphasis> du fichier, soit la plus récente version
   1.188            des deux versions qu'on souhaite fusionner.</para></listitem>
   1.189          <listitem><para id="x_352">Au centre, il y a <quote>notre</quote>
   1.190            version du fichier, avec le contenu que nous avons modifié.</para></listitem>
   1.191          <listitem><para id="x_353">Sur la droite, on trouve
   1.192          <quote>leur</quote> version du fichier, celui qui contient la
   1.193 -        révision que nous souhaitons intégré.</para>
   1.194 +        révision que nous souhaitons intégrer.</para>
   1.195          </listitem></itemizedlist>
   1.196        <para id="x_354">Dans le panneau en dessous, on trouve le
   1.197          <emphasis>résultat</emphasis> actuel de notre fusion. Notre tâche
   1.198 -        consiste donc à remplacement tous les textes en rouges,
   1.199 +        consiste donc à remplacer tous les textes en rouges,
   1.200          qui indiquent des conflits non résolus, avec une fusion manuelle et 
   1.201          pertinente de <quote>notre</quote> version et de la <quote>leur</quote>.
   1.202        </para>
   1.203 @@ -274,14 +274,14 @@
   1.204  
   1.205         <para id="x_357">Pour chaque portion de fichier posant problème, nous
   1.206           pouvons choisir de résoudre le conflit en utilisant une combinaison de
   1.207 -         texte depuis la version de base, la notre, ou la leur. Nous pouvons
   1.208 +         touches depuis la version de base, la notre, ou la leur. Nous pouvons
   1.209           aussi éditer manuellement les fichiers à tout moment, si c'est nécessaire.</para>
   1.210  
   1.211         <para id="x_358">Il y a <emphasis>beaucoup</emphasis> d'outils de
   1.212 -         fusion disponibles, bien trop pour en parler de tous ici. Leurs
   1.213 -         disponibilités varient selon les plate formes  ainsi que leurs
   1.214 -         avantages et inconvénients. La plupart sont optimisé pour
   1.215 -         la fusion de fichier contenant un texte plat, certains sont spécialisé
   1.216 +         fusion disponibles, bien trop pour parler de tous ici. Leurs
   1.217 +         disponibilités varient selon les plateformes  ainsi que leurs
   1.218 +         avantages et inconvénients. La plupart sont optimisés pour
   1.219 +         la fusion de fichier contenant un texte plat, certains sont spécialisés
   1.220           dans un format de fichier précis (généralement XML).</para>
   1.221      </sect2>
   1.222  
   1.223 @@ -290,12 +290,12 @@
   1.224  
   1.225        <para id="x_359">Dans cet exemple, nous allons reproduire la
   1.226          modification de l'historique du fichier de la figure <xref
   1.227 -        linkend="fig:tour-merge:conflict"/> ci dessus. Commençons par créer
   1.228 +        linkend="fig:tour-merge:conflict"/> ci-dessus. Commençons par créer
   1.229          un dépôt avec une version de base de notre document.</para>
   1.230  
   1.231        &interaction.tour-merge-conflict.wife; 
   1.232  
   1.233 -      <para id="x_35a">Créons un clone de ce dépôt et faisons une
   1.234 +      <para id="x_35a">Créons un clone de ce dépôt et effectuons une
   1.235          modification dans le fichier.</para>
   1.236  
   1.237        &interaction.tour-merge-conflict.cousin;
   1.238 @@ -315,12 +315,12 @@
   1.239        &interaction.tour-merge-conflict.pull;
   1.240  
   1.241        <para id="x_35d">Dans cette exemple, je n'utiliserais pas la commande Mercurial
   1.242 -        habituelle <command>hgmerge</command> pour effectuer le
   1.243 +        habituelle <command>hgmerge</command> pour effectuer la
   1.244          fusion (merge), car il me faudrait abandonner ce joli petit exemple automatisé
   1.245          pour utiliser un outil graphique. À la place, je vais définir la
   1.246          variable d'environnement <envar>HGMERGE</envar> pour indiquer à
   1.247          Mercurial d'utiliser la commande non-interactive <command>merge</command>.
   1.248 -        Cette dernière est embarquée par de nombreux systèmes <quote>à la Unix</quote>.
   1.249 +        Cette dernière est comprise dans de nombreux systèmes <quote>à la Unix</quote>.
   1.250          Si vous exécutez cet exemple depuis votre ordinateur, ne vous
   1.251          occupez pas de définir <envar>HGMERGE</envar>.</para>
   1.252  
   1.253 @@ -344,7 +344,7 @@
   1.254  
   1.255       <para id="x_361">Si la fusion (merge) automatique ou manuelle échoue, 
   1.256         il n'y a rien pour nous empêcher de <quote>corriger le tir</quote> en
   1.257 -       modifiant nous même les fichiers, et enfin effectuer le "commit" du 
   1.258 +       modifiant nous même les fichiers, et enfin effectuer le <quote>commit</quote> du 
   1.259         fichier:</para>
   1.260  
   1.261       &interaction.tour-merge-conflict.commit;
   1.262 @@ -353,19 +353,19 @@
   1.263         <title>Où est la <command>hg resolve</command> ?</title>
   1.264         
   1.265         <para id="x_724">La commande <command>hg resolve</command> a été
   1.266 -         introduit dans la version 1.1 de Mercurial, qui a été publié en
   1.267 +         introduit dans la version 1.1 de Mercurial, qui a été publiée en
   1.268           décembre 2008. Si vous utilisez une version plus anciennne de
   1.269           Mercurial (exécutez la command <command>hg version</command> pour en
   1.270 -         avoir le coeur net), cette commande ne sera pas disponible. Si votre
   1.271 +         avoir le cœur net), cette commande ne sera pas disponible. Si votre
   1.272           version de Mercurial est plus ancienne que la 1.1, vous devriez très
   1.273 -         fortement considérer une mise à jour à une version plus récente avant
   1.274 +         fortement considérer une mise à jour vers une version plus récente avant
   1.275           d'essayer de régler des fusions complexes.</para>
   1.276         </note>
   1.277       </sect2>
   1.278     </sect1>
   1.279  
   1.280     <sect1 id="sec:tour-merge:fetch">
   1.281 -     <title>Simplification de la séquence pull-merge-commit</title>
   1.282 +       <title>Simplification de la séquence <quote>pull-merge-commit</quote></title>
   1.283  
   1.284       <para id="x_362">La procédure pour effectuer la fusion indiquée
   1.285         ci-dessus est simple, mais requiert le lancement de trois commandes à la
   1.286 @@ -375,39 +375,39 @@
   1.287  hg merge
   1.288  hg commit -m 'Merged remote changes'</programlisting>
   1.289  
   1.290 -     <para id="x_363">Lors du "commit" final, vous devez également saisir un
   1.291 +     <para id="x_363">Lors du <quote>commit</quote> final, vous devez également saisir un
   1.292         message, qui aura vraisemblablement assez peu d'intérêt.</para>
   1.293  
   1.294       <para id="x_364">Il serait assez sympathique de pouvoir réduire le
   1.295         nombre d'opérations nécessaire, si possible. De fait Mercurial est
   1.296 -       fourni avec une extension appelé <literal role="hg-ext">fetch</literal>
   1.297 +       fournit avec une extension appelée <literal role="hg-ext">fetch</literal>
   1.298         qui fait justement cela.</para>
   1.299  
   1.300 -     <para id="x_365">Mercurial fourni un mécanisme d'extension flexible qui permet à chacun
   1.301 +     <para id="x_365">Mercurial fournit un mécanisme d'extension flexible qui permet à chacun
   1.302         d'étendre ces fonctionnalités, tout en conservant le cœur de Mercurial
   1.303 -       léger et facile à utiliser. Certains extensions ajoutent de nouvelles
   1.304 +       léger et facile à utiliser. Certaines extensions ajoutent de nouvelles
   1.305         commandes que vous pouvez utiliser en ligne de commande, alors que
   1.306 -       d'autres travaillent <quote>en coulisse,</quote> par exemple en ajoutant des
   1.307 +       d'autres travaillent <quote>en coulisse</quote>, par exemple en ajoutant des
   1.308         possibilités au serveur.</para>
   1.309  
   1.310       <para id="x_366">L'extension <literal role="hg-ext">fetch</literal>
   1.311         ajoute une nouvelle commande nommée, sans surprise, <command
   1.312 -       role="hg-cmd">hg fetch</command>. Cette extension résulte en une
   1.313 +       role="hg-cmd">hg fetch</command>. Cette extension consiste en une
   1.314         combinaison de <command role="hg-cmd">hg pull</command>, <command
   1.315 -       role="hg-cmd">hg update</command> and <command role="hg-cmd">hg
   1.316 +       role="hg-cmd">hg update</command> et <command role="hg-cmd">hg
   1.317         merge</command>. Elle commence par récupérer les modifications d'un
   1.318         autre dépôt dans le dépôt courant. Si elle trouve que les
   1.319 -       modifications ajoutent une nouvelle "head", elle effectue un "merge",
   1.320 -       et ensuite "commit" le résultat du "merge" avec un message généré
   1.321 -       automatiquement. Si aucune "head" n'ont été ajouté, elle met à jour le
   1.322 -       répertoire de travail au niveau de la nouvelle révision tip.</para>
   1.323 +       modifications ajoutent une nouvelle <quote>head</quote>, elle effectue un <quote>merge</quote>,
   1.324 +       et ensuite <quote>commit</quote> le résultat du <quote>merge</quote> avec un message généré
   1.325 +       automatiquement. Si aucune <quote>head</quote> n'a été ajouté, elle met à jour le
   1.326 +       répertoire de travail au niveau de la nouvelle révision <quote>tip</quote>.</para>
   1.327       
   1.328       <para id="x_367">Activer l'extension <literal
   1.329         role="hg-ext">fetch</literal> est facile. Modifiez votre <filename
   1.330         role="special">.hgrc</filename>, et soit allez à la section <literal
   1.331 -       role="rc-extensions">extensions</literal> soit créer une section
   1.332 +       role="rc-extensions">extensions</literal> soit créez une section
   1.333         <literal role="rc-extensions">extensions</literal>. Ensuite ajoutez
   1.334 -       une ligne qui consiste simplement en <quote>\Verb+fetch =</quote>.</para>
   1.335 +       une ligne qui consiste simplement en <quote>fetch =</quote>.</para>
   1.336  
   1.337       <programlisting>[extensions]
   1.338  fetch =</programlisting>
   1.339 @@ -431,16 +431,16 @@
   1.340  
   1.341      <para id="x_72a">Mercurial permet de faire ce genre de modification de
   1.342        manière fluide, à condition de l'informer de ce que nous faisons. Si 
   1.343 -      vous voulez renommenr un ficher, vous devriez utiliser les commande
   1.344 +      vous voulez renommer un ficher, vous devriez utiliser la commande
   1.345        <command>hg rename</command><footnote>
   1.346 -        <para id="x_72b">Si vous un utilisateur de Unix, vous serez content
   1.347 -          de savoir que la commande  <command>hg rename</command> command 
   1.348 +        <para id="x_72b">Si vous êtes un utilisateur d'Unix, vous serez content
   1.349 +          de savoir que la commande  <command>hg rename</command>
   1.350            peut être abrégée en <command>hg mv</command>.</para>
   1.351        </footnote> pour changer son nom, ainsi Mercurial peut ensuite prendre
   1.352        la bonne décision, plus tard, en cas de fusionv (merge).</para>
   1.353  
   1.354 -    <para id="x_72c">Nous étudierojns en détail l'utilisation de ces commandes, 
   1.355 -      en détail, dans le chapitre <xref linkend="chap:daily.copy"/>.</para>
   1.356 +    <para id="x_72c">Nous étudierons, en détail, l'utilisation de ces commandes 
   1.357 +     dans le chapitre <xref linkend="chap:daily.copy"/>.</para>
   1.358    </sect1>
   1.359  </chapter>
   1.360