1.1 --- a/fr/ch02-tour-basic.xml	Tue Sep 08 18:20:00 2009 +0200
     1.2 +++ b/fr/ch02-tour-basic.xml	Tue Sep 08 23:42:42 2009 +0200
     1.3 @@ -7,92 +7,94 @@
     1.4    <sect1>
     1.5      <title>Installer Mercurial sur votre système</title>
     1.6  
     1.7 -    <para id="x_1">Des paquetages binaires de Mercurial sont disponibles pour la plupart
     1.8 -des systèmes d'exploitation, ce qui rend facile l'utilisation immédiate
     1.9 -de Mercurial sur votre ordinateur.</para>
    1.10 +    <para id="x_1">Des paquetages binaires de Mercurial sont disponibles pour la
    1.11 +      plupart des systèmes d'exploitation, ce qui rend facile l'utilisation
    1.12 +      immédiate de Mercurial sur votre ordinateur.</para>
    1.13  
    1.14      <sect2>
    1.15        <title>Windows</title>
    1.16  
    1.17        <para id="x_c">La meilleur version de Mercurial pour Windows est
    1.18 -      TortoiseHg, qui peut être téléchargée ici : <ulink
    1.19 -      url="http://bitbucket.org/tortoisehg/stable/wiki/Home">http://bitbucket.org/tortoisehg/stable/wiki/Home</ulink>
    1.20 -      Ce logiciel n'a aucune dépendance exterieure; il fonctionne
    1.21 -      <quote>et c'est tout</quote>. Il fournit aussi bien les outils en ligne
    1.22 -      de commmande qu'un interface graphique.</para>
    1.23 - 
    1.24 -  <sect2>
    1.25 -
    1.26 -  <sect2>
    1.27 -    <title>Mac OS X</title>
    1.28 -
    1.29 -    <para id="x_a">Lee Cantey publie un installeur de Mercurial pour Mac OS X
    1.30 -    sur <ulink
    1.31 -    url="http://mercurial.berkwood.com">http://mercurial.berkwood.com</ulink>.</para>
    1.32 -  </sect2>
    1.33 -
    1.34 -  <sect2>
    1.35 -    <title>Linux</title>
    1.36 -
    1.37 -        <para id="x_2">Parce que chaque distribution de Linux a ses propres outils de gestion
    1.38 -          de paquets, politiques et rythmes de développements, il est difficile de
    1.39 -          donner un ensemble d'instructions uniques pour installer les binaires de
    1.40 -          Mercurial. La version de Mercurial avec laquelle vous vous retrouverez
    1.41 -          dépendra grandement de l'activité de la personne en charge du paquetage
    1.42 -          pour la distribution.</para>
    1.43 -
    1.44 -        <para id="x_3">Pour rester simple, je me concentrerai sur l'installation de Mercurial
    1.45 -          en ligne de commande, sous les distributions les plus courantes. La
    1.46 -          plupart des distributions fournissent des gestionnaires graphiques de
    1.47 -          paquetage qui vous permettront d'installer Mercurial en quelques clicks.
    1.48 -          Le paquetage devrait se nommer <literal>mercurial</literal>.</para>
    1.49 -
    1.50 -        <itemizedlist>
    1.51 -          <listitem><para id="x_4">Ubuntu et Debian:</para>
    1.52 -            <programlisting>apt-get install mercurial</listitem>
    1.53 -          <listitem><para id="x_5">Fedora:</para>
    1.54 -            <programlisting>yum install mercurial</programlisting>
    1.55 -          <listitem><para id="x_6">Gentoo:</para>
    1.56 -             <programlisting>emerge mercurial</programlisting></listitem>
    1.57 -          <listitem><para id="x_715">OpenSUSE:</para>
    1.58 -            <programlisting>zypper install mercurial</programlisting>
    1.59 -        </itemizedlist>
    1.60 -
    1.61 -      </sect2>
    1.62 -      <sect2>
    1.63 -        <title>Solaris</title>
    1.64 -
    1.65 -        <para id="x_09">SunFreeWare, à <ulink 
    1.66 -        url="http://www.sunfreeware.com">http://www.sunfreeware.com</ulink>,
    1.67 -        fournit des paquet précompilés pour Mercurial.</para>
    1.68 -     </sect2>
    1.69 -  <sect1>
    1.70 +        TortoiseHg, qui peut être téléchargée ici : <ulink
    1.71 +          url="http://bitbucket.org/tortoisehg/stable/wiki/Home">http://bitbucket.org/tortoisehg/stable/wiki/Home</ulink>.
    1.72 +        Ce logiciel n'a aucune dépendance exterieure; il fonctionne <quote>et
    1.73 +          c'est tout</quote>. Il fournit aussi bien les outils en ligne de
    1.74 +        commmande qu'une interface graphique.</para>
    1.75 + 
    1.76 +    </sect2>
    1.77 +
    1.78 +    <sect2>
    1.79 +      <title>Mac OS X</title>
    1.80 +  
    1.81 +      <para id="x_a">Lee Cantey publie un installeur de Mercurial pour Mac OS
    1.82 +        X sur <ulink
    1.83 +          url="http://mercurial.berkwood.com">http://mercurial.berkwood.com</ulink>.</para>
    1.84 +    </sect2>
    1.85 +      
    1.86 +    <sect2>
    1.87 +      <title>Linux</title>
    1.88 +
    1.89 +      <para id="x_2">Parce que chaque distribution de Linux a ses propres
    1.90 +        outils de gestion de paquets, politiques et rythmes de
    1.91 +        développements, il est difficile de donner un ensemble
    1.92 +        d'instructions unique pour installer les binaires de Mercurial. La
    1.93 +        version de Mercurial avec laquelle vous vous retrouverez dépendra
    1.94 +        grandement de l'activité de la personne en charge du paquetage pour
    1.95 +        la distribution.</para>
    1.96 +
    1.97 +      <para id="x_3">Pour rester simple, je me concentrerai sur
    1.98 +        l'installation de Mercurial en ligne de commande, sous les
    1.99 +        distributions les plus courantes. La plupart des distributions
   1.100 +        fournissent des gestionnaires graphiques de paquetage qui vous
   1.101 +        permettront d'installer Mercurial en quelques clicks. Le paquetage
   1.102 +        devrait se nommer <literal>mercurial</literal>.</para>
   1.103 +
   1.104 +      <itemizedlist>
   1.105 +        <listitem><para id="x_4">Ubuntu et Debian:</para>
   1.106 +          <programlisting>apt-get install mercurial</listitem>
   1.107 +        <listitem><para id="x_5">Fedora:</para>
   1.108 +          <programlisting>yum install mercurial</programlisting>
   1.109 +        <listitem><para id="x_6">Gentoo:</para>
   1.110 +           <programlisting>emerge mercurial</programlisting></listitem>
   1.111 +        <listitem><para id="x_715">OpenSUSE:</para>
   1.112 +          <programlisting>zypper install mercurial</programlisting>
   1.113 +      </itemizedlist>
   1.114 +
   1.115 +    </sect2>
   1.116 +    <sect2>
   1.117 +      <title>Solaris</title>
   1.118 +
   1.119 +      <para id="x_09">SunFreeWare, à <ulink 
   1.120 +      url="http://www.sunfreeware.com">http://www.sunfreeware.com</ulink>,
   1.121 +      fournit des paquets précompilés pour Mercurial.</para>
   1.122 +    </sect2>
   1.123 +  </sect1>
   1.124  
   1.125    <sect1>
   1.126      <title>Commencer à utiliser Mercurial</title>
   1.127  
   1.128 -      <para id="x_e">Pour commencer, nous utiliserons la commande <command role="hg-cmd">hg 
   1.129 -      version</command> pour vérifier si Mercurial est installé proprement. Les 
   1.130 -      informations affichées sur la version ne sont pas réellement importantes en 
   1.131 -      soit, c'est surtout de savoir si elles s'affichent qui nous
   1.132 -      intéresse.</para>
   1.133 -
   1.134 -  &interaction.tour.version;
   1.135 -
   1.136 -  <sect2>
   1.137 -    <title>L'aide intégrée</title>
   1.138 -
   1.139 -    <para id="x_e">Mercurial fournit un système d'aide intégré, ce qui est 
   1.140 -        inestimable quand vous vous retrouvez coincé à essayer de vous rappeler 
   1.141 -        comment lancer une commande. Si vous êtes bloqué, exécutez simplement 
   1.142 -        <command role="hg-cmd">hg help</command>; elle affichera une brève
   1.143 -        liste des commandes, avec une description pour chacune. Si vous demandez 
   1.144 -        de l'aide sur une commande spécifique (voir ci-dessous), elle affichera
   1.145 -        des informations plus détaillées.</para>
   1.146 -
   1.147 -        &interaction.tour.help;
   1.148 -
   1.149 -        <para id="x_10">Pour un niveau d'informations encore plus détaillées 
   1.150 +    <para id="x_e">Pour commencer, nous utiliserons la commande <command
   1.151 +        role="hg-cmd">hg version</command> pour vérifier si Mercurial est
   1.152 +      installé proprement. Les informations affichées sur la version ne sont
   1.153 +      pas réellement importantes en soit, c'est surtout de savoir si elles
   1.154 +      s'affichent qui nous intéresse.</para>
   1.155 +
   1.156 +    &interaction.tour.version;
   1.157 +
   1.158 +    <sect2>
   1.159 +      <title>L'aide intégrée</title>
   1.160 +
   1.161 +      <para id="x_e">Mercurial fournit un système d'aide intégré, ce qui est
   1.162 +        inestimable quand vous vous retrouvez coincé à essayer de vous
   1.163 +        rappeler comment lancer une commande. Si vous êtes bloqué, exécutez
   1.164 +        simplement <command role="hg-cmd">hg help</command>; elle affichera
   1.165 +        une brève liste des commandes, avec une description pour chacune. Si
   1.166 +        vous demandez de l'aide sur une commande spécifique (voir
   1.167 +        ci-dessous), elle affichera des informations plus détaillées.</para>
   1.168 +
   1.169 +      &interaction.tour.help;
   1.170 +
   1.171 +      <para id="x_10">Pour un niveau d'informations encore plus détaillé 
   1.172          (ce dont vous aurez rarement besoin), exécuter <command role="hg-cmd">hg 
   1.173          help <option role="hg-opt-global">-v</option></command>.  L'option 
   1.174          <option role="hg-opt-global">-v</option> est l'abréviation de 
   1.175 @@ -110,7 +112,7 @@
   1.176  
   1.177      <para id="x_12">Il n'y a rien de particulièrement magique au sujet de 
   1.178        ce dépôt, c'est simplement une arborescence sur votre système de fichiers 
   1.179 -      de Mercurial traite de manière spéciale. Vous pouvez renommer ou effacer 
   1.180 +      que Mercurial traite de manière spéciale. Vous pouvez renommer ou effacer 
   1.181        ce répertoire à n'impporte quel moment, en utilisant la ligne de commande 
   1.182        ou votre explorateur de fichiers.</para>
   1.183  
   1.184 @@ -123,32 +125,34 @@
   1.185          Mercurial. Cette commande est appelée <command role="hg-cmd">hg clone</command>, 
   1.186          car elle crée une copie identique à un dépôt existant.</para>
   1.187  
   1.188 -     &interaction.tour.clone;
   1.189 -
   1.190 -     <para id="x_67c">Un avantage de la commande <command
   1.191 -     role="hg-cmd">hg clone</command> est que, comme nous l'avons vu ci
   1.192 -     dessus, elle nous permet de faire de cloner les dépôts à travers le 
   1.193 -     réseau. Un autre est qu'elle se rappelle d'où a été cloné un dépôt, ce
   1.194 -     qui est utile quand on veut mettre à jour le clone.</para>
   1.195 -
   1.196 -     <para id="x_14">Si votre opération de clonage réussit, vous devriez maintenant
   1.197 +      &interaction.tour.clone;
   1.198 +
   1.199 +      <para id="x_67c">Un avantage de la commande <command role="hg-cmd">hg
   1.200 +          clone</command> est que, comme nous l'avons vu ci dessus, elle nous
   1.201 +        permet de faire de cloner les dépôts à travers le réseau. Un autre
   1.202 +        est qu'elle se rappelle d'où a été cloné un dépôt, ce qui est utile
   1.203 +        quand on veut mettre à jour le clone.</para>
   1.204 +
   1.205 +      <para id="x_14">Si votre opération de clonage réussit, vous devriez maintenant
   1.206          avoir un répertoire local appelé <filename class="directory">hello</filename>. 
   1.207          Ce répertoire contiendra quelques fichiers.</para>
   1.208  
   1.209 -     &interaction.tour.ls;
   1.210 -
   1.211 -     <para id="x_15">Ces fichiers ont le même contenu et historique dans votre dépôt
   1.212 -       qu'ils ont dans le dépôt que vous avez cloné.</para>
   1.213 -
   1.214 -     <para id="x_16">Chaque dépôt Mercurial est complet, autonome et indépendant. Il
   1.215 -       contient sa propre copie privée des fichiers du projet et de leur
   1.216 -       historique. Le clone d'un dépôt se souvient de la localisation du
   1.217 -       dépôt à partir duquel il a été clôné, mais il ne communique pas avec
   1.218 -       ce dernier, ou un autre, à moins que vous ne lui demandiez.</para>
   1.219 -
   1.220 -     <para id="x_17">Ce que tout ceci signifie pour le moment est que nous sommes libres
   1.221 -       d'expérimenter avec ce dépôt, confiants dans le fait qu'il s'agit d'un
   1.222 -       <quote>bac à sable</quote> qui n'affectera personne d'autre.</para>
   1.223 +      &interaction.tour.ls;
   1.224 +
   1.225 +      <para id="x_15">Ces fichiers ont le même contenu et historique dans votre dépôt
   1.226 +        qu'ils ont dans le dépôt que vous avez cloné.</para>
   1.227 +
   1.228 +      <para id="x_16">Chaque dépôt Mercurial est complet, autonome et
   1.229 +        indépendant. Il contient sa propre copie privée des fichiers du
   1.230 +        projet et de leur historique. Le clone d'un dépôt se souvient de la
   1.231 +        localisation du dépôt à partir duquel il a été clôné, mais il ne
   1.232 +        communique pas avec ce dernier, ou un autre, à moins que vous ne lui
   1.233 +        demandiez.</para>
   1.234 +
   1.235 +      <para id="x_17">Ce que tout ceci signifie pour le moment est que nous
   1.236 +        sommes libres d'expérimenter avec ce dépôt, confiants dans le fait
   1.237 +        qu'il s'agit d'un <quote>bac à sable</quote> qui n'affectera personne
   1.238 +        d'autre.</para>
   1.239  
   1.240      </sect2>  
   1.241      <sect2>
   1.242 @@ -159,7 +163,7 @@
   1.243          </filename>. C'est ici que Mercurial conserve toutes ses
   1.244          métadonnées.</para>
   1.245  
   1.246 -       &interaction.tour.ls-a; 
   1.247 +      &interaction.tour.ls-a; 
   1.248  
   1.249        <para id="x_19">Le contenu du répertoire <filename class="directory">.hg
   1.250          </filename> et ses sous répertoires sont les seuls propres à Mercurial. 
   1.251 @@ -186,7 +190,7 @@
   1.252        La commande <command role="hg-cmd">hg log</command> vous donne une 
   1.253        vue de l'historique.</para>
   1.254  
   1.255 -    &interaction.tour.log; -->
   1.256 +    &interaction.tour.log;
   1.257  
   1.258      <para "x_1c">Par défaut, cette commande affiche à l'écran un bref paragraphe pour chaque
   1.259        révision enregistrée pour ce projet. Dans la terminologie de Mercurial, nous
   1.260 @@ -194,36 +198,38 @@
   1.261        qu'il contient un ensemble de modifications sur plusieurs fichiers.</para>
   1.262  
   1.263      <para id="x_1d">La commande <command role="hg-cmd">hg log</command> affiche 
   1.264 -    ainsi ces informations:</para>
   1.265 +    ainsi ces informations :</para>
   1.266  
   1.267      <itemizedlist>
   1.268 -      <listitem><para id="x_1e"><literal>changeset</literal>: Ce champ contient 
   1.269 +      <listitem><para id="x_1e"><literal>changeset</literal> : Ce champ contient 
   1.270          un nombre, séparé par deux points (:), d'une chaine hexadécimale. Il 
   1.271          s'agit en fait d'<emphasis>identifiants</emphasis>  d'un changeset. Il y a 
   1.272          deux identifiants car le numéro de la révision est plus court et plus à 
   1.273          facile à saisir qu'une séquence hexadécimale.</para>
   1.274        </listitem>
   1.275 -      <listitem><para id="x_1f"><literal>user</literal>: L'identité de la personne 
   1.276 +      <listitem><para id="x_1f"><literal>user</literal> : L'identité de la personne 
   1.277          qui a créée ce  %%% laisser le terme anglais car il sera affiché
   1.278          changeset. C'est un champ libre de forme, mais la plupart du
   1.279          temps il contient le nom et l'email de la personne.</para>
   1.280        </listitem>
   1.281 -      <listitem><para id="x_20"><literal>date</literal>: La date et l'heure à 
   1.282 -        laquelle le \textit{changeset a été créé, ainsi que le fuseau horaire dans 
   1.283 -        laquelle il a été créé. <!--TODO: Translate 'timezone' properly : FUSEA -->. (La 
   1.284 -        date et l'heure sont locales à ce \textit{fuseau}, elles indiquent donc quelle 
   1.285 -        date et heure il était pour la personne qui a créé ce <!--%%%TODO: je suppose (quelle 
   1.286 -        "heure")  OUI --> changeset.</para>
   1.287 +      <listitem><para id="x_20"><literal>date</literal> : La date et l'heure à 
   1.288 +        laquelle le \textit{changeset} a été créé, ainsi que le fuseau horaire dans 
   1.289 +        lequelle il a été créé. (La date et l'heure sont locales à ce
   1.290 +        \textit{fuseau}, elles indiquent donc quelle date et heure il était
   1.291 +        pour la personne qui a créé ce changeset.</para>
   1.292        </listitem>
   1.293 -      <listitem><para id="x_21"><literal>résumé</literal>: La première du 
   1.294 +      <listitem><para id="x_21"><literal>résumé</literal>: La première ligne du 
   1.295          message que le créateur a associé à son changeset pour le décrire.</para>
   1.296        </listitem>
   1.297 -      <!-- TODO: Missing items here ! -->
   1.298 +      <listitem><para id="x_67d">Certains changesets, comme le premier de la
   1.299 +        liste ci-dessus ont un champ <literal>tag</literal>. Le tag est une autre
   1.300 +        façon d'identifier un changeset en lui donnant un nom simple à retenir.
   1.301 +        (Le tag nommé <literal>tip</literal> est spécial : il fait toujours
   1.302 +        référence aux derniers changements dans le dépôt.)</para></listitem>
   1.303      </itemizedlist>
   1.304  
   1.305      <para id="x_22">Par défaut, la commande <command role="hg-cmd">hg log</command> 
   1.306 -      n'affiche qu'un résumé, il manque
   1.307 -      beaucoup de détails.</para>
   1.308 +      n'affiche qu'un résumé, il manque beaucoup de détails.</para>
   1.309  
   1.310      <para id="x_23">La figure <xref linkend="fig:tour-basic:history"/> fournit une 
   1.311        représentation graphique de l'historique du dépôt <filename class="directory">hello
   1.312 @@ -245,23 +251,22 @@
   1.313      <sect2>
   1.314        <title>Changesets, révisions, et collaboration</title>
   1.315        
   1.316 -      <para id="x_25">Comme l'anglais est réputé pour être un langage maladroit, et que l'informatique
   1.317 -        est la source de bien des erreurs de terminologies (pourquoi utiliser un
   1.318 -        seul terme quand quatre feront l'affaire ?), la gestion de version a une
   1.319 -        variété de mots et de phrases qui veulent dire la même chose. Si vous
   1.320 -        discutez d'historique de Mercurial avec d'autres personnes,
   1.321 -<!--%%%TODO: ça ne veut rien dire: il faut supprimer une des personnes : soit "quelqu'un",
   1.322 -% soit "à d'autres personnes" -->
   1.323 -        vous constaterez que souvent le mot <quote>changeset</quote> est contracté simplement
   1.324 -        en <quote>change</quote> ou (à l'écrit) <quote>cset</quote>, et même parfois un
   1.325 -        changeset simplement <quote>révision</quote>, abrégé en <quote>rev</quote>.</para>
   1.326 +      <para id="x_25">Comme l'anglais est réputé pour être un langage maladroit,
   1.327 +        et que l'informatique est la source de bien des erreurs de terminologie
   1.328 +        (pourquoi utiliser un seul terme quand quatre feront l'affaire ?), la
   1.329 +        gestion de version a une variété de mots et de phrases qui veulent dire
   1.330 +        la même chose. Si vous discutez d'historique de Mercurial avec d'autres
   1.331 +        personnes, vous constaterez que souvent, le mot <quote>changeset</quote>
   1.332 +        est contracté simplement en <quote>change</quote> ou (à l'écrit)
   1.333 +        <quote>cset</quote>, et même parfois un changeset
   1.334 +        <quote>révision</quote>, abrégé en <quote>rev</quote>.</para>
   1.335  
   1.336        <para id="x_26">Bien que le <emphasis>mot</emphasis> que vous utilisez pour 
   1.337          désigner le concept de changeset importe peu, l'<emphasis>identifiant</emphasis> 
   1.338          que vous utilisez pour désigner un <emphasis>changeset</emphasis> spécifique 
   1.339          a une grande importance. Rappelez vous que le champ changeset affiché par la
   1.340 -        commande <command role="hg-cmd">hg log</command> identifie un changeset à la fois avec
   1.341 -        un numéro de révision et une séquence hexadécimale.</para>
   1.342 +        commande <command role="hg-cmd">hg log</command> identifie un changeset à
   1.343 +        la fois avec un numéro de révision et une séquence hexadécimale.</para>
   1.344  
   1.345        <itemizedlist>
   1.346          <listitem><para id="x_27">Le numéro de révision est <emphasis>seulement 
   1.347 @@ -271,22 +276,21 @@
   1.348          pourra toujours être associé au changeset exact de <emphasis>chaque</emphasis> 
   1.349          copie de votre dépôt.</para></listitem></itemizedlist>
   1.350  
   1.351 -     <para id="x_29">La distinction est importante. Si vous envoyez un email 
   1.352 -       à quelqu'un en parlant de la <quote>révision 33</quote>, il est très 
   1.353 -       probable que sa révision 33 <emphasis>ne sera pas la même</emphasis> 
   1.354 -       que la votre. La raison de ceci est que le numéro de révision dépend 
   1.355 -       de l'ordre dans lequel les modifications sont arrivées dans le dépôt, 
   1.356 -       et il n'y a aucune garantie que les mêmes changements soient arrivés 
   1.357 -       dans le même ordre dans différents dépôts. Trois modifications
   1.358 -       <literal>a,b,c</literal> peuvent aisément apparaitre dans un dépôt 
   1.359 -       comme <literal>0,1,2</literal>, et dans un autre comme <literal>0,2,1
   1.360 -       </literal>.</para>
   1.361 -
   1.362 -    <para id="x_2a">Mercurial utilise les numéros de révision uniquement comme des raccourcis
   1.363 -      pratiques. Si vous devez discuter d'un \textit{changeset} avec quelqu'un,
   1.364 -      ou identifer un \textit{changeset} pour une quelquonque %%%TODO: our : "pour" ou "ou"
   1.365 -      raison (par exemple, un rapport de \textit{bug}), utilisez la séquence
   1.366 -      hexadécimale.</para>
   1.367 +      <para id="x_29">La distinction est importante. Si vous envoyez un email 
   1.368 +         à quelqu'un en parlant de la <quote>révision 33</quote>, il est très 
   1.369 +         probable que sa révision 33 <emphasis>ne sera pas la même</emphasis> 
   1.370 +         que la votre. La raison de ceci est que le numéro de révision dépend 
   1.371 +         de l'ordre dans lequel les modifications sont arrivées dans le dépôt, 
   1.372 +         et il n'y a aucune garantie que les mêmes changements soient arrivés 
   1.373 +         dans le même ordre dans différents dépôts. Trois modifications
   1.374 +         <literal>a,b,c</literal> peuvent aisément apparaitre dans un dépôt 
   1.375 +         comme <literal>0,1,2</literal>, et dans un autre comme <literal>0,2,1
   1.376 +         </literal>.</para>
   1.377 +
   1.378 +      <para id="x_2a">Mercurial utilise les numéros de révision uniquement comme des raccourcis
   1.379 +        pratiques. Si vous devez discuter d'un \textit{changeset} avec quelqu'un,
   1.380 +        ou identifer un \textit{changeset} pour une quelconque raison (par exemple,
   1.381 +        un rapport de \textit{bug}), utilisez la séquence hexadécimale.</para>
   1.382  
   1.383      </sect2>
   1.384      <sect2>
   1.385 @@ -300,19 +304,17 @@
   1.386  
   1.387        &interaction.tour.log-r;
   1.388  
   1.389 -      <para id="x_2c">Si vous voulez voir l'historique de plusieurs 
   1.390 -      révisions sans avoir à les énumérer, vous pouvez utiliser la 
   1.391 -      <emphasis>intervalle de numérotation</emphasis> qui vous permet 
   1.392 -      d'exprimer l'idée <quote>je veux toutes les révisions entre $a$ 
   1.393 -      et $b$, inclus</quote>.
   1.394 -
   1.395 -     &interaction.tour.log.range;
   1.396 -
   1.397 -     <para id="x_2d">Mercurial respecte aussi l'ordre dans lequel 
   1.398 -     vous spécifiez les révisions, ainsi 
   1.399 -     <command role="hg-cmd">hg log -r 2:4</command> affichera
   1.400 -     <literal>2,3,4</literal> alors que <command role="hg-cmd">hg log -r 4:2</command> 
   1.401 -     affichera <literal>4,3,2</literal>.</para>
   1.402 +      <para id="x_2c">Si vous voulez voir l'historique de plusieurs révisions
   1.403 +        sans avoir à les énumérer, vous pouvez utiliser la <emphasis>intervalle
   1.404 +        de numérotation</emphasis> qui vous permet d'exprimer l'idée <quote>je
   1.405 +        veux toutes les révisions entre $a$ et $b$, inclus</quote></para>
   1.406 +
   1.407 +      &interaction.tour.log.range;
   1.408 +
   1.409 +      <para id="x_2d">Mercurial respecte aussi l'ordre dans lequel vous spécifiez
   1.410 +        les révisions, ainsi <command role="hg-cmd">hg log -r 2:4</command>
   1.411 +        affichera <literal>2,3,4</literal> alors que <command role="hg-cmd">hg
   1.412 +        log -r 4:2</command> affichera <literal>4,3,2</literal>.</para>
   1.413  
   1.414      </sect2>  
   1.415      <sect2>
   1.416 @@ -322,15 +324,12 @@
   1.417          est suffisant si vous savez déjà ce que vous cherchez. En 
   1.418          revanche, vous aurez probablement besoin de voir une description 
   1.419          complète du changement, ou une liste des fichiers modifiés si vous 
   1.420 -        cherchez à déterminer qu'un changeset est bien celui que vous <!--
   1.421 -     %%%TODO: les propositions sont mal construites : après un "si...." il
   1.422 -     faut une proposition sans "si... donc ici : "si ... recherchez", ben
   1.423 -      quoi?  -->
   1.424 +        cherchez à déterminer qu'un changeset est bien celui que vous
   1.425          recherchez. L'option \hgopt{-v} de la commande <command role="hg-cmd">hg 
   1.426          log</command> (ou <option role="hp-opt-global">--verbose</option>) vous 
   1.427          donne ces informations supplémentaires.</para>
   1.428  
   1.429 -      &interaction.tour.log-v; -->
   1.430 +      &interaction.tour.log-v;
   1.431  
   1.432        <para id="x_2f">Si vous voulez voir à la fois la description 
   1.433          et le contenu d'une modification, ajouter l'option <option 
   1.434 @@ -344,9 +343,8 @@
   1.435  
   1.436        &interaction.tour.log-vp;
   1.437  
   1.438 -      <para id="x_67e">L'option <option role="hg-opt-log">-p</option> option
   1.439 -       est incroyablement utile, il est donc important dans s'en 
   1.440 -       rappeller.</para>
   1.441 +      <para id="x_67e">L'option <option role="hg-opt-log">-p</option> est
   1.442 +        incroyablement utile, il est donc important dans s'en rappeller.</para>
   1.443  
   1.444      </sect2>
   1.445    </sect1>
   1.446 @@ -359,9 +357,8 @@
   1.447        utile pour la suite de notre parcours.</para>
   1.448  
   1.449      <para id="x_31">Mercurial utilise une approche directe et cohérente 
   1.450 -      pour interpréter <!--%%%TODO: une manière d'approche ?--> les 
   1.451 -      options que vous passez aux commandes. Il suit une convention commune 
   1.452 -      à la plupart des systèmes Unix et Linux modernes.</para>
   1.453 +      pour interpréter les options que vous passez aux commandes. Il suit une
   1.454 +      convention commune à la plupart des systèmes Unix et Linux modernes.</para>
   1.455  
   1.456      <itemizedlist>
   1.457        <listitem><para id="x_32">Chaque option a un nom complet. Par exemple, 
   1.458 @@ -401,13 +398,12 @@
   1.459      <note>
   1.460        <title>Option naming consistency</title>
   1.461        
   1.462 -      <para id="x_680">Presque toujours, les commandes de Mercurial utilise
   1.463 +      <para id="x_680">Presque toujours, les commandes de Mercurial utilisent
   1.464        des noms d'options cohérentes pour référer à des concepts identiques.
   1.465        Par exemple, si une commande concerne les changesets, vous les
   1.466 -      identifierais toujours avec l'option <option
   1.467 -      role="hg-opt-log">-r</option>. Cette utilisation cohérente des noms
   1.468 -      d'options permet de mémoriser plus facilement quelles options accepte
   1.469 -      une commande.</para>
   1.470 +      identifierez toujours avec l'option <option role="hg-opt-log">-r</option>.
   1.471 +      Cette utilisation cohérente des noms d'options permet de mémoriser plus
   1.472 +      facilement quelles options accepte une commande.</para>
   1.473     </note>
   1.474  
   1.475  
   1.476 @@ -419,226 +415,229 @@
   1.477        commandes pour consulter l'historique de Mercurial, regardons 
   1.478        comment faire des modifications et les examiner.</para>
   1.479       
   1.480 -   <para id="x_39">La première chose que nous allons faire 
   1.481 -     c'est isoler notre expérience dans un dépôt à part. Nous 
   1.482 -     allons utiliser la commande <command role="hg-cmd">hg 
   1.483 -     clone</command>, mais nous n'avons pas besoin de faire une 
   1.484 -     copie de dépôt distant. Comme nous avons déjà une copie locale, 
   1.485 -     nous pouvons juste faire un clone de celle-ci à la place. C'est 
   1.486 -     beaucoup plus rapide que de faire une copie à travers le réseau, 
   1.487 -     et un dépôt cloné localement prend également moins d'espace 
   1.488 -     disque.<footnote></footnote>
   1.489 -       <para id="x_681">L'économie d'espace disque apparait clairement
   1.490 -       quand les dépôts source et destination sont sur le même système
   1.491 -       de fichier, où dans ce cas, Mercurial utilisera des liens physiques
   1.492 -       pour effectuer des partages copie-lors-des-écritures de ses 
   1.493 -       métadonnées internes. Si cette explication ne signifie rien pour
   1.494 -       vous, ne vous inquietez pas: tout ceci se passe de manière
   1.495 -       transparente et automatiquement, et vous n'avez pas du tout
   1.496 -       besoin de comprendre ceci.</para>
   1.497 -       </footnote>.</para>
   1.498 -   
   1.499 -   &interaction.tour.reclone;
   1.500 -
   1.501 -   <para id="x_3a">On notera au passage qu'il est souvent considéré 
   1.502 -     comme une bonne pratique de conserver une copie <quote>immaculée</quote> 
   1.503 -     du dépôt distant, à partir de laquelle vous pourrez faire des 
   1.504 -     copies locales temporaires pour créer des <quote>bacs à sable</quote> 
   1.505 -     pour chaque tâche sur laquelle vous souhaitez travailler. Ceci 
   1.506 -     vous permet de travailler sur plusieurs choses en parallèle, 
   1.507 -     chacune isolée les unes des autres en attendant que ces tâches 
   1.508 -     soient finies et que vous soyez prêt à les réintégrer. Parce 
   1.509 -     que les copies locales sont peu coûteuses, il est très rapide 
   1.510 -     de créer ou détruire des dépôts dès que vous en avez besoin.
   1.511 -   </para>
   1.512 -
   1.513 -   <para id="x_3b">Dans notre <filename class="directory">my-hello
   1.514 -     </filename> dépôts, nous avons un fichier <filename>hello.c
   1.515 -     </filename> qui contient le classique <quote>hello, world</quote>.
   1.516 -   </para>
   1.517 -   
   1.518 -   &interaction.tour.cat1;
   1.519 -
   1.520 -   <para id="x_682">Editons ce fichier pour qu'il affiche une autre
   1.521 -   ligne sur la sortie standard.</para>
   1.522 -
   1.523 -   &interaction.tour.cat2;
   1.524 -
   1.525 -   <para id="x_3c">La commande Mercurial <command role="hg-cmd">hg status
   1.526 -     </command> nous dira ce que Mercurial sait des fichiers du dépôts.
   1.527 -   </para>
   1.528 -
   1.529 -   &interaction.tour.status;
   1.530 -
   1.531 -   <para id="x_3d">La commande <command role="hg-cmd">hg status</command>
   1.532 -     n'affichera pas le contenu des fichiers, mais une ligne commençant
   1.533 -     par <quote><literal>M</literal></quote> pour <filename>hello.c
   1.534 -     </filename>. A moins que vous lui demandiez, la commande <command 
   1.535 -     role="hg-cmd">hg status</command> n'affichera aucune informations
   1.536 -     sur les fichiers que vous n'avez pas modifié.</para>
   1.537 -
   1.538 -   <para id="x_3d">Le <quote><literal>M</literal></quote> indique que
   1.539 -     Mercurial a remarqué que nous avons modifié le fichier 
   1.540 -     <filename>hello.c</filename>. Nous n'avons pas besoin
   1.541 -     <emphasis>d'informer</emphasis> Mercurial que nous allons modifier le
   1.542 -     fichier avant de commencer à le faire, ou que nous avions modifier le
   1.543 -     fichier avant de le faire, il est capable de découvrir ça tout seul.
   1.544 -   </para>
   1.545 -
   1.546 -   <para id="x_3f">C'est déjà pratique de savoir que nous avons modifié le
   1.547 -   fichier <filename>hello.c</filename>, mais nous préférerions savoir
   1.548 -   exactement <emphasis>ce que</emphasis> nous avons changé. Pour ceci, nous
   1.549 -   utilisons la commande <command role="hg-cmd">hg diff</command>.</para>
   1.550 -
   1.551 -   &interaction.tour.diff;
   1.552 -
   1.553 -   <tip>
   1.554 -     <title>Comprendre les patches</title>
   1.555 -   
   1.556 -     <para id="x_683">Penser à jeter un oeil au site <xref
   1.557 -     linkend="sec:mq:patch"/> si vous n'arrivez pas à lire la sortie
   1.558 -     ci-dessus.</para>
   1.559 -   </tip>
   1.560 - </sect1>
   1.561 - <sect1>
   1.562 -   <title>Enregister vos modifications dans une nouvelle révision</title>
   1.563 -   
   1.564 -   <para id="x_40">Nous pouvons modifier des fichiers, compiler et 
   1.565 -     tester nos modifications, et utiliser les commandes 
   1.566 -     <command role="hg-cmd">hg status</command> et <command role="hg-cmd">hg 
   1.567 -     diff</command> pour voir les modifications effectuées, jusqu'au 
   1.568 -     moment où nous serons assez satisfaits
   1.569 -     pour décider d'enregistrer notre travail dans un \textit{changeset}.
   1.570 -   </para>
   1.571 -
   1.572 -   <para id="x_41">La commande <command role="hg-cmd">hg commit</command> 
   1.573 -     vous laisse créer une nouvelle révision, nous désignerons généralement 
   1.574 -     cette opération par <quote>faire un commit</quote> ou <quote>committer
   1.575 -     </quote>.</para>
   1.576 -
   1.577 -   <sect2>
   1.578 -   <title>Définir le nom d'utilisateur</title>
   1.579 -
   1.580 -     <para id="x_42">Quand vous exécutez la commande <command role="hg-cmd">
   1.581 -       hg commit</command> pour la première fois, il n'est pas garanti
   1.582 -       qu'elle réussisse du premier coup. En effet, Mercurial enregistre
   1.583 -       votre nom et votre adresse avec chaque modification que vous effectuez, 
   1.584 -       de manière à ce que vous soyez capable (ou d'autres le soient) de 
   1.585 -       savoir qui a fait quelle modification. Mercurial essaye automatiquement 
   1.586 -       de découvrir un nom d'utilisateur qui ait un minimum de sens 
   1.587 -       pour effectuer l'opération de commit avec. Il va essayer chacune 
   1.588 -       des méthodes suivantes, dans l'ordre:</para>
   1.589 -     <orderedlist>
   1.590 -       <listitem><para id="x_43">Si vous spécifiez l'option <option 
   1.591 -         role="hg-opt-commit">-u</option> avec la commande
   1.592 -         <command role="hg-cmd">hg commit</command>, suivi d'un nom 
   1.593 -         d'utilisateur, ceci aura toujours la priorité sur les autres 
   1.594 -         méthodes ci dessous.</para></listitem>
   1.595 -       <listitem><para id="x_44">Si vous avez défini une variable d'environnement 
   1.596 -         <envar>HGUSER</envar>, c'est cette valeur qui est alors utilisée.</para></listitem>
   1.597 -      <listitem><para id="x_45">Si vous créez un fichier nommé 
   1.598 -        <filename role="special">.hgrc</filename> dans votre
   1.599 -        répertoire \textit{home}, avec une entrée <envar 
   1.600 -        role="rc-item-ui">username</envar>, c'est la valeur associée 
   1.601 -        qui sera utilisée. Pour voir à quoi ressemble le contenu de ce fichier 
   1.602 -        regardez la section <xref linkend="sec:tour-basic:username"/> 
   1.603 -        ci-dessous.</para></listitem>
   1.604 -      <listitem><para id="x_46">Si vous avez défini une variable 
   1.605 -        d'environnement <envar>EMAIL</envar> celle ci sera utilisée ensuite.</para></listitem>
   1.606 -      <listitem><para id="x_47">Enfin, Mercurial interrogera votre système pour 
   1.607 -        trouver votre nom d'utilisateur local ainsi que le nom de la machine hôte, 
   1.608 -        et il fabriquera un nom d'utilisateur à partir de ces données. Comme
   1.609 -        il arrive souvent que ce genre de noms soit totalement inutile, il vous
   1.610 -        préviendra en affichant un message d'avertissement.</para></listitem>
   1.611 -   </orderedlist>
   1.612 -
   1.613 -   <para id="x_48">Si tous ces mécanismes échouent, Mercurial n'exécutera pas
   1.614 -     la commande, affichant un message d'erreur. Dans ce cas, il ne vous 
   1.615 -     laissera pas effectuer de commit tant que vous n'aurez pas défini un nom
   1.616 -     d'utilisateur.</para>
   1.617 -
   1.618 -   <para id="x_49">Vous devriez penser à utiliser la variable d'environement 
   1.619 -     <envar>HGUSER</envar> et l'option <option role="hg-opt-commit">-u
   1.620 -     </option> comme moyen pour <emphasis>changer</emphasis> le nom d'
   1.621 -     utilisateur} par défaut. Pour une utilisation normale, la manière la 
   1.622 -     plus simple et robuste d'opérer est de créer un fichier 
   1.623 -     <filename role="special">.hgrc</filename>, voir ci-dessous pour 
   1.624 -     les détails à ce sujet.</para>
   1.625 -
   1.626 -   <sect3 id="sec:tour-basic:username">
   1.627 -     <title>Créer un fichier de configuration pour Mercurial</title>
   1.628 -
   1.629 -     <para id="x_4a">Pour définir un nom d'utilisateur, utilisez votre 
   1.630 -       éditeur de texte favori pour créer un fichier <filename 
   1.631 -       role="special">.hgrc</filename> dans votre répertoire home. 
   1.632 -       Mercurial va utiliser ce fichier pour retrouver votre 
   1.633 -       configuration personnelle. Le contenu initial devrait 
   1.634 -       ressembler à ceci:</para>
   1.635 -
   1.636 -     <tip>
   1.637 -       <title><quote>Home directory</quote> on Windows</title>
   1.638 +    <para id="x_39">La première chose que nous allons faire c'est isoler notre
   1.639 +      expérience dans un dépôt à part. Nous allons utiliser la commande <command
   1.640 +        role="hg-cmd">hg clone</command>, mais nous n'avons pas besoin de faire
   1.641 +      une copie de dépôt distant. Comme nous avons déjà une copie locale, nous
   1.642 +      pouvons juste faire un clone de celle-ci à la place. C'est beaucoup plus
   1.643 +      rapide que de faire une copie à travers le réseau, et un dépôt cloné
   1.644 +      localement prend également moins d'espace disque<footnote>
   1.645 +      <para id="x_681">L'économie d'espace disque apparait clairement quand les
   1.646 +        dépôts source et destination sont sur le même système de fichier, où, dans
   1.647 +        ce cas, Mercurial utilisera des liens physiques pour effectuer des partages
   1.648 +        copie-lors-des-écritures de ses métadonnées internes. Si cette explication
   1.649 +        ne signifie rien pour vous, ne vous inquietez pas : tout ceci se passe de
   1.650 +        manière transparente et automatiquement. Vous n'avez pas du tout besoin de
   1.651 +        comprendre ceci.</para></footnote>.</para>
   1.652 +  
   1.653 +    &interaction.tour.reclone;
   1.654 +
   1.655 +    <para id="x_3a">On notera au passage qu'il est souvent considéré comme
   1.656 +      une bonne pratique de conserver une copie <quote>immaculée</quote>
   1.657 +      du dépôt distant, à partir de laquelle vous pourrez faire des 
   1.658 +      copies locales temporaires pour créer des <quote>bacs à sable</quote> 
   1.659 +      pour chaque tâche sur laquelle vous souhaitez travailler. Ceci 
   1.660 +      vous permet de travailler sur plusieurs choses en parallèle, 
   1.661 +      chacune isolée les unes des autres en attendant que ces tâches 
   1.662 +      soient finies et que vous soyez prêt à les réintégrer. Parce 
   1.663 +      que les copies locales sont peu coûteuses, il est très rapide 
   1.664 +      de créer ou détruire des dépôts dès que vous n'en avez plus
   1.665 +      besoin.</para>
   1.666 +
   1.667 +    <para id="x_3b">Dans notre dépôt <filename
   1.668 +        class="directory">my-hello</filename>, nous avons un fichier
   1.669 +      <filename>hello.c</filename> qui contient le classique <quote>hello,
   1.670 +        world</quote>.</para>
   1.671 +   
   1.672 +    &interaction.tour.cat1;
   1.673 +
   1.674 +    <para id="x_682">Editons ce fichier pour qu'il affiche une autre ligne
   1.675 +      sur la sortie standard.</para>
   1.676 +    
   1.677 +    &interaction.tour.cat2;
   1.678 +
   1.679 +    <para id="x_3c">La commande Mercurial <command role="hg-cmd">hg
   1.680 +        status</command> nous dira ce que Mercurial sait des fichiers du
   1.681 +      dépôts.</para>
   1.682 +
   1.683 +    &interaction.tour.status;
   1.684 +
   1.685 +    <para id="x_3d">La commande <command role="hg-cmd">hg status</command>
   1.686 +      n'affichera pas le contenu des fichiers, mais une ligne commençant par
   1.687 +      <quote><literal>M</literal></quote> pour <filename>hello.c</filename>.
   1.688 +      A moins que vous lui demandiez, la commande <command role="hg-cmd">hg
   1.689 +        status</command> n'affichera aucune information sur les fichiers que
   1.690 +      vous n'avez pas modifiés.</para>
   1.691 + 
   1.692 +    <para id="x_3d">Le <quote><literal>M</literal></quote> indique que
   1.693 +      Mercurial a remarqué que nous avons modifié le fichier
   1.694 +      <filename>hello.c</filename>. Nous n'avons pas besoin
   1.695 +      <emphasis>d'informer</emphasis> Mercurial que nous allons modifier un
   1.696 +      fichier avant de commencer à le faire, ou que nous avons modifié un
   1.697 +      fichier après avoir commencé à le faire, il est capable de découvrir ça
   1.698 +      tout seul. </para>
   1.699 +
   1.700 +    <para id="x_3f">C'est déjà pratique de savoir que nous avons modifié le
   1.701 +      fichier <filename>hello.c</filename>, mais nous préférerions savoir
   1.702 +      exactement <emphasis>ce que</emphasis> nous avons changé. Pour ceci, nous
   1.703 +      utilisons la commande <command role="hg-cmd">hg diff</command>.</para>
   1.704 +
   1.705 +    &interaction.tour.diff;
   1.706 +
   1.707 +    <tip>
   1.708 +      <title>Comprendre les patches</title>
   1.709 +   
   1.710 +      <para id="x_683">Penser à jeter un oeil à <xref
   1.711 +          linkend="sec:mq:patch"/> si vous n'arrivez pas à lire la sortie
   1.712 +        ci-dessus.</para>
   1.713 +    </tip>
   1.714 +  </sect1>
   1.715 +  <sect1>
   1.716 +    <title>Enregister vos modifications dans une nouvelle révision</title>
   1.717 +   
   1.718 +    <para id="x_40">Nous pouvons modifier des fichiers, compiler et tester
   1.719 +      nos modifications, et utiliser les commandes <command role="hg-cmd">hg
   1.720 +        status</command> et <command role="hg-cmd">hg diff</command> pour
   1.721 +      voir les modifications effectuées, jusqu'à ce que nous soyons assez
   1.722 +      satisfaits pour décider d'enregistrer notre travail dans un
   1.723 +      \textit{changeset}.</para>
   1.724 +
   1.725 +    <para id="x_41">La commande <command role="hg-cmd">hg commit</command>
   1.726 +      vous laisse créer une nouvelle révision, nous désignerons généralement
   1.727 +      cette opération par <quote>faire un commit</quote> ou
   1.728 +      <quote>committer</quote>.</para>
   1.729 +
   1.730 +    <sect2>
   1.731 +    <title>Définir le nom d'utilisateur</title>
   1.732 +
   1.733 +      <para id="x_42">Quand vous exécutez la commande <command
   1.734 +          role="hg-cmd">hg commit</command> pour la première fois, il n'est
   1.735 +        pas garanti qu'elle réussisse du premier coup. En effet, Mercurial
   1.736 +        enregistre votre nom et votre adresse avec chaque modification que
   1.737 +        vous effectuez, de manière à ce que vous soyez capable (ou d'autres
   1.738 +        le soient) de savoir qui a fait quelle modification. Mercurial essaye
   1.739 +        automatiquement de découvrir un nom d'utilisateur qui ait un minimum
   1.740 +        de sens pour effectuer l'opération de commit avec. Il va essayer
   1.741 +        chacune des méthodes suivantes, dans l'ordre :</para>
   1.742 +
   1.743 +      <orderedlist>
   1.744 +        <listitem><para id="x_43">Si vous spécifiez l'option <option
   1.745 +              role="hg-opt-commit">-u</option> avec la commande <command
   1.746 +              role="hg-cmd">hg commit</command>, suivi d'un nom
   1.747 +            d'utilisateur, ceci aura toujours la priorité sur les autres
   1.748 +            méthodes ci dessous.</para></listitem>
   1.749 +        <listitem><para id="x_44">Si vous avez défini une variable
   1.750 +            d'environnement <envar>HGUSER</envar>, c'est cette valeur qui est
   1.751 +            alors utilisée.</para></listitem>
   1.752 +        <listitem><para id="x_45">Si vous créez un fichier nommé <filename
   1.753 +              role="special">.hgrc</filename> dans votre répertoire
   1.754 +            \textit{home}, avec une entrée <envar
   1.755 +              role="rc-item-ui">username</envar>, c'est la valeur associée
   1.756 +            qui sera utilisée. Pour voir à quoi ressemble le contenu de ce
   1.757 +            fichier regardez la section <xref
   1.758 +              linkend="sec:tour-basic:username"/>
   1.759 +            ci-dessous.</para></listitem>
   1.760 +        <listitem><para id="x_46">Si vous avez défini une variable
   1.761 +            d'environnement <envar>EMAIL</envar> celle ci sera utilisée
   1.762 +            ensuite.</para></listitem>
   1.763 +        <listitem><para id="x_47">Enfin, Mercurial interrogera votre système
   1.764 +            pour trouver votre nom d'utilisateur local ainsi que le nom de la
   1.765 +            machine hôte, et il fabriquera un nom d'utilisateur à partir de
   1.766 +            ces données. Comme il arrive souvent que ce genre de noms soit
   1.767 +            totalement inutile, il vous préviendra en affichant un message
   1.768 +            d'avertissement.</para></listitem>
   1.769 +      </orderedlist>
   1.770 +   
   1.771 +      <para id="x_48">Si tous ces mécanismes échouent, Mercurial n'exécutera
   1.772 +        pas la commande, affichant un message d'erreur. Dans ce cas, il ne
   1.773 +        vous laissera pas effectuer de commit tant que vous n'aurez pas
   1.774 +        défini un nom d'utilisateur.</para>
   1.775 +   
   1.776 +      <para id="x_49">Vous devriez penser à utiliser la variable
   1.777 +        d'environement <envar>HGUSER</envar> et l'option <option
   1.778 +          role="hg-opt-commit">-u</option> comme moyen pour
   1.779 +        <emphasis>changer</emphasis> le nom d'utilisateur par défaut. Pour
   1.780 +        une utilisation normale, la manière la plus simple et robuste
   1.781 +        d'opérer est de créer un fichier <filename
   1.782 +          role="special">.hgrc</filename>, voir ci-dessous pour  les détails
   1.783 +        à ce sujet.</para>
   1.784 +
   1.785 +      <sect3 id="sec:tour-basic:username">
   1.786 +        <title>Créer un fichier de configuration pour Mercurial</title>
   1.787 +
   1.788 +        <para id="x_4a">Pour définir un nom d'utilisateur, utilisez votre 
   1.789 +          éditeur de texte favori pour créer un fichier <filename 
   1.790 +            role="special">.hgrc</filename> dans votre répertoire home. 
   1.791 +          Mercurial va utiliser ce fichier pour retrouver votre 
   1.792 +          configuration personnelle. Le contenu initial devrait
   1.793 +          ressembler à ceci :</para>
   1.794 +   
   1.795 +        <tip>
   1.796 +          <title><quote>Home directory</quote> sous Windows</title>
   1.797 +   
   1.798 +          <para id="x_716">Quand on parle de répertoire home, sur une version
   1.799 +            anglaise d'une installation de Windows, il s'agira habituellement
   1.800 +            d'un répertoire nommée comme votre nom dans <filename>C:\Documents 
   1.801 +              and Settings</filename>. Vous pouvez trouver de quelle répertoire
   1.802 +            il s'agit en lançant une fenêtre d'interpréteur de commande et en
   1.803 +            exécutant la commande suivante :</para>
   1.804            
   1.805 -       <para id="x_716">Quand on parle de répertoire home, sur une version
   1.806 -         anglaise d'une installation de Windows, il s'agira habituellement
   1.807 -         d'un répertoire nommée comme votre nom dans <filename>C:\Documents 
   1.808 -         and Settings</filename>. Vous pouvez trouver de quelle répertoire
   1.809 -         il s'agit en lançant une fenêtre d'interpréteur de commande et en
   1.810 -         exécutant la commande suivante:</para>
   1.811 -        <screen><prompt>C:\</prompt> <userinput>echo %UserProfile</userinput></screen>
   1.812 -     </tip>
   1.813 - 
   1.814 -     <programlisting># This is a Mercurial configuration file.
   1.815 +          <screen><prompt>C:\</prompt> <userinput>echo
   1.816 +              %UserProfile</userinput></screen>
   1.817 +        </tip>
   1.818 +   
   1.819 +        <programlisting># This is a Mercurial configuration file.
   1.820  [ui]
   1.821  username = Firstname Lastname &lt;email.address@domain.net&gt;</programlisting>
   1.822  
   1.823 -     <para id="x_4b">La ligne avec <literal>[ui]</literal> commence une
   1.824 -       <emphasis>section</emphasis> du fichier de configuration, ainsi la ligne
   1.825 -       <quote><literal>username = ...</literal></quote> signifie <quote>
   1.826 -       définir la valeur de l'élément <literal>username</literal> dans la
   1.827 -       section <literal>ui</literal></quote>. Une section continue jusqu'à ce
   1.828 -       qu'une nouvelle commence, ou que la fin du fichier soit atteinte.
   1.829 -       Mercurial ignore les lignes vides et traite tout texte situé à la suite
   1.830 -       d'un <quote><literal>#</literal></quote> jusqu'à la fin de la ligne
   1.831 -       comme un commentaire.</para>
   1.832 +        <para id="x_4b">La ligne avec <literal>[ui]</literal> commence une
   1.833 +          <emphasis>section</emphasis> du fichier de configuration, ainsi la ligne
   1.834 +          <quote><literal>username = ...</literal></quote> signifie <quote>
   1.835 +            définir la valeur de l'élément <literal>username</literal> dans la
   1.836 +            section <literal>ui</literal></quote>. Une section continue jusqu'à ce
   1.837 +          qu'une nouvelle commence, ou que la fin du fichier soit atteinte.
   1.838 +          Mercurial ignore les lignes vides et traite tout texte situé à la suite
   1.839 +          d'un <quote><literal>#</literal></quote> jusqu'à la fin de la ligne
   1.840 +          comme un commentaire.</para>
   1.841  
   1.842        </sect3>
   1.843        <sect3>
   1.844          <title>Choisir un nom d'utilisateur</title>
   1.845 -
   1.846 -       <para id="x_4c">Vous pouvez utiliser n'importe quelle valeur 
   1.847 -         pour votre <literal>username</literal>, car cette information 
   1.848 -         est destinée à d'autres personnes et non à être interprétée 
   1.849 -         par Mercurial. La convention que la plupart des personnes
   1.850 -         suivent est d'utiliser leurs noms suivies de leurs adresses emails,
   1.851 -         comme montrée ci-dessus:</para>
   1.852 -      <note>
   1.853 -        <para id="x_4d">Le mécanisme interne du serveur web intégré à Mercurial,
   1.854 -          masque les adresses emails, pour rendre plus difficile leurs
   1.855 -          récupérations par les outils utilisés par les spammmers.
   1.856 -          Ceci réduit la probabilité que de recevoir encore plus de
   1.857 -          spam si vous vous publiez un dépôt sur internet.</para>
   1.858 -      </note>
   1.859 -    </sect3>
   1.860 -  </sect2>
   1.861 -  <sect2>
   1.862 -    <title>Rédiger un message de \textit{commit}</title>
   1.863 -
   1.864 -    <para id="x_4e">Lorsqu'on effectue une opération de commit, Mercurial
   1.865 -      lance automatiquement un éditeur de texte pour permettre de saisir
   1.866 -      un message qui décrira les modifications effectuées dans cette
   1.867 -      révision. Ce message est nommé le <emphasis>message de commit</emphasis>. 
   1.868 -      Ce sera un enregistrement pour tout lecteur expliquant le pourquoi 
   1.869 -      et le comment de vos modifications, et il sera affiché par la 
   1.870 -      commande <command role="hg-cmd">hg log</command>.</para>
   1.871 -
   1.872 -     &interaction.tour.commit; 
   1.873 -
   1.874 -    <para id="x_4f">L'éditeur que la commande <command role="hg-cmd">hg 
   1.875 -    commit</command> déclenche ne contiendra qu'une ligne vide suivi 
   1.876 -    d'un certain nombre de lignes commençant par <quote><literal>HG:
   1.877 -    </literal></quote>.</para>
   1.878 -
   1.879 -    <programlisting>
   1.880 + 
   1.881 +        <para id="x_4c">Vous pouvez utiliser n'importe quelle valeur 
   1.882 +          pour votre <literal>username</literal>, car cette information 
   1.883 +          est destinée à d'autres personnes et non à être interprétée 
   1.884 +          par Mercurial. La convention que la plupart des personnes
   1.885 +          suivent est d'utiliser leurs noms suivies de leurs adresses emails,
   1.886 +          comme montré ci-dessus :</para>
   1.887 +        <note>
   1.888 +          <para id="x_4d">Le mécanisme interne du serveur web intégré à Mercurial,
   1.889 +            masque les adresses emails, pour rendre plus difficile leurs
   1.890 +            récupérations par les outils utilisés par les spammmers.
   1.891 +            Ceci réduit la probabilité que de recevoir encore plus de
   1.892 +            spam si vous vous publiez un dépôt sur internet.</para>
   1.893 +        </note>
   1.894 +      </sect3>
   1.895 +    </sect2>
   1.896 +    <sect2>
   1.897 +      <title>Rédiger un message de \textit{commit}</title>
   1.898 +  
   1.899 +      <para id="x_4e">Lorsqu'on effectue une opération de commit, Mercurial
   1.900 +        lance automatiquement un éditeur de texte pour permettre de saisir
   1.901 +        un message qui décrira les modifications effectuées dans cette
   1.902 +        révision. Ce message est nommé le <emphasis>message de commit</emphasis>. 
   1.903 +        Ce sera un enregistrement pour tout lecteur expliquant le pourquoi 
   1.904 +        et le comment de vos modifications, et il sera affiché par la 
   1.905 +        commande <command role="hg-cmd">hg log</command>.</para>
   1.906 + 
   1.907 +      &interaction.tour.commit; 
   1.908 +  
   1.909 +      <para id="x_4f">L'éditeur que la commande <command role="hg-cmd">hg 
   1.910 +          commit</command> déclenche ne contiendra qu'une ligne vide suivi 
   1.911 +        d'un certain nombre de lignes commençant par <quote><literal>HG:
   1.912 +        </literal></quote>.</para>
   1.913 +    
   1.914 +        <programlisting>
   1.915      This is where I type my commit comment.
   1.916      
   1.917      HG: Enter commit message.  Lines beginning with 'HG:' are removed.
   1.918 @@ -648,87 +647,90 @@
   1.919      HG: changed hello.c</programlisting>
   1.920  
   1.921  
   1.922 -    <para id="x_50">Mercurial ignore les lignes qui commencent 
   1.923 -      avec <quote><literal>HG:</literal></quote>, il ne les 
   1.924 -      utilise que pour nous indiquer quels fichiers modifiés il se
   1.925 -      prépare à \textit{commiter}. Modifier ou effacer ces lignes n'a
   1.926 -      aucune conséquence sur l'opération de commit.
   1.927 -   </para>
   1.928 -
   1.929 -  </sect2>
   1.930 -  <sect2>
   1.931 -    <title>Rédiger un message \textit{approprié}</title>
   1.932 -
   1.933 -    <para id="x_51">Comme <command role="hg-cmd">hg log</command> n'affiche
   1.934 -      que la première ligne du message de commit par défaut, il est souvent
   1.935 -      considéré comme une bonne pratique de rédiger des messages de commit
   1.936 -      qui tiennent sur une seule ligne. Voilà un exemple concret de message 
   1.937 -      de commit qui <emphasis>ne suit pas</emphasis> cette directive, et qui a donc
   1.938 -      un résumé peu lisible.</para>
   1.939 -
   1.940 -    <programlisting>
   1.941 +      <para id="x_50">Mercurial ignore les lignes qui commencent 
   1.942 +        avec <quote><literal>HG:</literal></quote>, il ne les 
   1.943 +        utilise que pour nous indiquer quels fichiers modifiés il se
   1.944 +        prépare à \textit{commiter}. Modifier ou effacer ces lignes n'a
   1.945 +        aucune conséquence sur l'opération de commit.
   1.946 +      </para>
   1.947 +
   1.948 +    </sect2>
   1.949 +    <sect2>
   1.950 +      <title>Rédiger un message \textit{approprié}</title>
   1.951 +  
   1.952 +      <para id="x_51">Comme <command role="hg-cmd">hg log</command> n'affiche
   1.953 +        que la première ligne du message de commit par défaut, il est souvent
   1.954 +        considéré comme une bonne pratique de rédiger des messages de commit
   1.955 +        qui tiennent sur une seule ligne. Voilà un exemple concret de message 
   1.956 +        de commit qui <emphasis>ne suit pas</emphasis> cette directive, et
   1.957 +        qui a donc un résumé peu lisible.</para>
   1.958 +
   1.959 +      <programlisting>
   1.960  changeset:   73:584af0e231be
   1.961  user:        Censored Person &lt;censored.person@example.org&gt;
   1.962  date:        Tue Sep 26 21:37:07 2006 -0700
   1.963  summary:     include buildmeister/commondefs.   Add an exports and install
   1.964 -    </programlisting>
   1.965 -
   1.966 -    <para id="x_52">A ce sujet, il faut noter qu'il n'existe pas de règle 
   1.967 -      absolue dans ce domaine. Mercurial lui-même n'interprète pas les 
   1.968 -      contenus des messages de commit, ainsi votre projet est libre de 
   1.969 -      concevoir différentes politiques de mise en page des messages.</para>
   1.970 -    <para id="x_53">Ma préférence personnelle va au message court, mais 
   1.971 -    informatif, qui offre des précisions supplémentaires par rapport à ce 
   1.972 -    que pourrait m'apprendre une commande <command role="hg-cmd">hg log 
   1.973 -    --patch</command>.</para>
   1.974 -    <para id="x_55">Si vous exécutez la commande <command role="hg-cmd">hg
   1.975 -     commit</command> sans aucun argument, elle enregistre tout les 
   1.976 -     changements qui ont été fait, et qui sont indiqué par les commandes
   1.977 -     <command role="hg-cmd">hg status</command> et  <command 
   1.978 -     role="hg-cmd">hg diff</command>.</para>
   1.979 -   <note>
   1.980 -     <title>Une surprise pour les utilisateurs habitués à Subversion</title>
   1.981 -
   1.982 -     <para id="x_717">Comme n'importe quel autre commande de Mercurial, si
   1.983 -     vous soumettez pas de manière explicite les noms des fichiers à
   1.984 -     committer à la commande <command role="hg-cmd">hg commit</command>, elle
   1.985 -     va travailler sur l'ensemble du répertoire de travail. Soyez conscient
   1.986 -     de ceci si vous venez du monde Subversion ou CVS, car vous pourriez
   1.987 -     attendre qu'elle opère uniquement le répertoire courant et ses sous
   1.988 -     répertoires.</para>
   1.989 -   </note>
   1.990 -  </sect2>
   1.991 -  <sect2>
   1.992 -    <title>Annuler un \textit{commit}</title>
   1.993 +      </programlisting>
   1.994 +  
   1.995 +      <para id="x_52">A ce sujet, il faut noter qu'il n'existe pas de règle 
   1.996 +        absolue dans ce domaine. Mercurial lui-même n'interprète pas les 
   1.997 +        contenus des messages de commit, ainsi votre projet est libre de 
   1.998 +        concevoir différentes politiques de mise en page des messages.</para>
   1.999 +      
  1.1000 +      <para id="x_53">Ma préférence personnelle va au message court, mais 
  1.1001 +        informatif, qui offre des précisions supplémentaires par rapport à ce 
  1.1002 +        que pourrait m'apprendre une commande <command role="hg-cmd">hg log 
  1.1003 +          --patch</command>.</para>
  1.1004 +      
  1.1005 +      <para id="x_55">Si vous exécutez la commande <command role="hg-cmd">hg
  1.1006 +          commit</command> sans aucun argument, elle enregistre tous les 
  1.1007 +        changements qui ont été fait, et qui sont indiqué par les commandes
  1.1008 +        <command role="hg-cmd">hg status</command> et  <command 
  1.1009 +          role="hg-cmd">hg diff</command>.</para>
  1.1010 +      
  1.1011 +      <note>
  1.1012 +        <title>Une surprise pour les utilisateurs habitués à Subversion</title>
  1.1013 +   
  1.1014 +        <para id="x_717">Comme n'importe quel autre commande de Mercurial, si
  1.1015 +          vous soumettez pas de manière explicite les noms des fichiers à
  1.1016 +          committer à la commande <command role="hg-cmd">hg commit</command>, elle
  1.1017 +          va travailler sur l'ensemble du répertoire de travail. Soyez conscient
  1.1018 +          de ceci si vous venez du monde Subversion ou CVS, car vous pourriez
  1.1019 +          attendre qu'elle opère uniquement le répertoire courant et ses sous
  1.1020 +          répertoires.</para>
  1.1021 +      </note>
  1.1022 +    </sect2>
  1.1023 +    <sect2>
  1.1024 +      <title>Annuler un \textit{commit}</title>
  1.1025  
  1.1026        <para id="x_54">Si, en rédigeant le message, vous décidez que 
  1.1027          finalement vous ne voulez pas effectuer ce commit, il suffit 
  1.1028          de quitter simplement l'éditeur sans sauver. Ceci n'aura aucune 
  1.1029          conséquence sur le dépôt ou les fichiers du répertoire de 
  1.1030          travail.</para>
  1.1031 -  </sect2>
  1.1032 -
  1.1033 -  <sect2>
  1.1034 -  <sect2>
  1.1035 -    <title>Admirer votre travail</title>
  1.1036 -
  1.1037 -    <para id="x_56">Une fois que votre \textit{commit} est terminé, vous pouvez utiliser
  1.1038 -      la commande <command role="hg-cmd">hg tip</command> pour afficher le \textit{changeset} que nous
  1.1039 -      venons de créer. Cette commande produit une sortie à l'écran qui est
  1.1040 -      identique à celle du <command role="hg-cmd">hg log</command>, mais qui n'affiche que la dernière
  1.1041 -      révision du dépôt.</para>
  1.1042 -
  1.1043 -     &interaction.tour.tip; 
  1.1044 -
  1.1045 -    <para id="x_57">On fait couramment référence à la dernière révision 
  1.1046 -      du dépôt comme étant la <emphasis>révision tip</emphasis>, ou plus
  1.1047 -      simplement le <emphasis>tip</emphasis>.</para>
  1.1048 -
  1.1049 -    <para id="x_684">Au passage, la commande <command role="hg-cmd">hg
  1.1050 -        tip</command> accepte la plupart des mêmes options que 
  1.1051 -        <command role="hg-cmd">hg log</command>, ainsi <option
  1.1052 -        role="hg-opt-global">-v</option> ci dessus inplique <quote>soit
  1.1053 -        verbeux</quote>, <option role="hg-opt-tip">-p</option>
  1.1054 +    </sect2>
  1.1055 +  
  1.1056 +    <sect2>
  1.1057 +      <title>Admirer votre travail</title>
  1.1058 +  
  1.1059 +      <para id="x_56">Une fois que votre \textit{commit} est terminé, vous
  1.1060 +        pouvez utiliser la commande <command role="hg-cmd">hg tip</command>
  1.1061 +        pour afficher le \textit{changeset} que vous venez de créer. Cette
  1.1062 +        commande produit  une sortie à l'écran qui est identique à celle du
  1.1063 +        <command role="hg-cmd">hg log</command>, mais qui n'affiche que la
  1.1064 +        dernière révision du dépôt.</para>
  1.1065 + 
  1.1066 +      &interaction.tour.tip; 
  1.1067 +  
  1.1068 +      <para id="x_57">On fait couramment référence à la dernière révision 
  1.1069 +        du dépôt comme étant la <emphasis>révision tip</emphasis>, ou plus
  1.1070 +        simplement le <emphasis>tip</emphasis>.</para>
  1.1071 +  
  1.1072 +      <para id="x_684">Au passage, la commande <command role="hg-cmd">hg
  1.1073 +          tip</command> accepte la plupart des options qu'accepte 
  1.1074 +        <command role="hg-cmd">hg log</command>. Ainsi <option
  1.1075 +          role="hg-opt-global">-v</option> ci dessus implique <quote>soit
  1.1076 +          verbeux</quote>, <option role="hg-opt-tip">-p</option>
  1.1077          veux dire <quote>affiche le patch</quote>. L'utilisation de l'option
  1.1078          <option role="hg-opt-tip">-p</option> pour afficher un patch est un
  1.1079          autre exemple de la cohérence des commandes évoquée plus tôt.</para>
  1.1080 @@ -739,267 +741,272 @@
  1.1081      <title>Partager ses modifications</title>
  1.1082  
  1.1083      <para id="x_58">Nous avons mentionné plus haut que les dépôts 
  1.1084 -    de Mercurial sont autosuffisants. Ce qui signifie que la nouvelle
  1.1085 -    révision que vous venez de créer n'existe seulement dans votre 
  1.1086 -    répertoire <filename class="directory">my-hello</filename>. Étudions 
  1.1087 -    comment propager cette modification dans d'autres dépôts.</para>
  1.1088 +      de Mercurial sont autosuffisants. Ce qui signifie que la nouvelle
  1.1089 +      révision que vous venez de créer existe seulement dans votre 
  1.1090 +      répertoire <filename class="directory">my-hello</filename>. Étudions 
  1.1091 +      comment propager cette modification dans d'autres dépôts.</para>
  1.1092  
  1.1093      <sect2 id="sec:tour:pull">
  1.1094        <title>Récupérer les modifications d'autres dépôts</title>
  1.1095  
  1.1096        <para id="x_5a">Pour commencer, construisons un clone de notre dépôt 
  1.1097 -      <filename class="directory">hello</filename> qui ne contiendra pas 
  1.1098 -      le changement que nous venons d'effectuer. Nous l'appellerons notre 
  1.1099 -      dépôt temporaire <filename class="directory">hello-pull</filename>.</para>
  1.1100 -
  1.1101 -     &interaction.tour.clone-pull;
  1.1102 -
  1.1103 -     <para id="x_5a">Nous allons utiliser la commande <command
  1.1104 -       role="hg-cmd">hg pull</command> pour envoyer les modifications depuis
  1.1105 -       <filename class="directory">my-hello</filename> dans <filename 
  1.1106 -       class="directory">hello-pull</filename>. Néanmoins, récupérer
  1.1107 -       aveuglement des modifications depuis un dépôt a quelque chose d'un peu 
  1.1108 -       effrayant. Mercurial propose donc une commande <command
  1.1109 -       role="hg-cmd">hg incoming</command> qui permet de savoir quelles modifications
  1.1110 -       la commande <command role="hg-cmd">hg pull</command> <emphasis>pourrait</emphasis> 
  1.1111 -       entraîner dans notre dépôt, et ceci sans effectuer réellement de modification 
  1.1112 -       dessus.</para>
  1.1113 +        <filename class="directory">hello</filename> qui ne contiendra pas 
  1.1114 +        le changement que nous venons d'effectuer. Nous l'appellerons notre 
  1.1115 +        dépôt temporaire <filename
  1.1116 +          class="directory">hello-pull</filename>.</para>
  1.1117 + 
  1.1118 +      &interaction.tour.clone-pull;
  1.1119 + 
  1.1120 +      <para id="x_5a">Nous allons utiliser la commande <command
  1.1121 +          role="hg-cmd">hg pull</command> pour envoyer les modifications
  1.1122 +        depuis <filename class="directory">my-hello</filename> dans <filename
  1.1123 +          class="directory">hello-pull</filename>. Néanmoins, récupérer
  1.1124 +        aveuglement des modifications depuis un dépôt a quelque chose d'un
  1.1125 +        peu effrayant. Mercurial propose donc une commande <command
  1.1126 +          role="hg-cmd">hg incoming</command> qui permet de savoir quelles
  1.1127 +        modifications la commande <command role="hg-cmd">hg pull</command>
  1.1128 +        <emphasis>pourrait</emphasis> entraîner dans notre dépôt, et ceci
  1.1129 +        sans effectuer réellement de modification dessus.</para>
  1.1130  
  1.1131        &interaction.tour.incoming; 
  1.1132 -
  1.1133 -    <para id="x_5c">Apporter les modifications rapatriées dans 
  1.1134 -      un dépôt se résume donc à exécuter la commande <command 
  1.1135 -      role="hg-cmd">hg pull</command>, et préciser depuis quel dépôt
  1.1136 -      effectuer le <command role="hg-cmd">hg pull</command>.</para>
  1.1137 -
  1.1138 -     &interaction.tour.pull;
  1.1139 -
  1.1140 -    <para id="x_5d">Comme vous le voyez avec une sortie avant et après de la
  1.1141 -    commande <command role="hg-cmd">hg tip</command>, nous avons réussi à
  1.1142 -    récupérer aisément les modifications dans notre dépôt. Il reste néanmoins
  1.1143 -    quelque chose à faire avant de placer ces modifications dans l'espace de
  1.1144 -    travail.</para>
  1.1145 -   
  1.1146 -   <tip>
  1.1147 -     <title>Récupérer des changements précis</title>
  1.1148 -
  1.1149 -     <para id="x_5b">Il est possible à cause du délai entre l'exécution de la
  1.1150 -       commande <command role="hg-cmd">hg incoming</command> et l'exécution de
  1.1151 -       la commande <command role="hg-cmd">hg pull</command>, que vous ne
  1.1152 -       puissiez pas voir toutes les modifications que vous rapporterez d'un
  1.1153 -       autre dépôt. Suppossons que vous récupériez les modifications d'un dépôt
  1.1154 -       situé quelque part sur le réeau. Alors que vous regardez le résultat de
  1.1155 -       la commande <command role="hg-cmd">hg incoming</command>, et avant que
  1.1156 -       vous ne décidiez de récupérer ces modifications, quelqu'un peut ajouter
  1.1157 -       de nouvelles révisions dans le dépôt distant. Ce qui signigie que vous
  1.1158 -       récupérer plus de révision que ce que vous aviez regarder en utilisant
  1.1159 -       la commande <command role="hg-cmd">hg incoming</command>.</para>
  1.1160 -     <para id="x_718">Si vous voulez seulement récupérer ce que vous aviez
  1.1161 -       vérifier à l'aide de la commande <command role="hg-cmd">hg
  1.1162 -       incoming</command>, ou que pour d'autres raisons vous souhaitiez ne
  1.1163 -       récupérer qu'un sous ensemble des révisions supplémentaires
  1.1164 -       disponibles, indiquant simplement les modifications que vous souhaitez
  1.1165 -       récupérer par leurs ID de révision, soit <command>hg pull
  1.1166 -       -r7e95bb</command>. </para>
  1.1167 -    </tip>
  1.1168 -  </sect2>
  1.1169 -  <sect2>
  1.1170 -    <title>Mise à jour de l'espace de travail</title>
  1.1171 -
  1.1172 -    <para id="x_5e">Nous a:vons jusqu'à maintenant grossièrement définie la
  1.1173 -      relation entre un dépôt et un espace de travail. La commande <command
  1.1174 -      role="hg-cmd">hg pull</command> que nous avons exécutée dans la section 
  1.1175 -      <xref linkend="sec:tour:pull"/> a apporté des modifications, que nous
  1.1176 -      avons vérifiées, dans notre dépôt, mais il n'y a aucune trace de ces
  1.1177 -      modifications dans notre espace de travail. En effet, <command
  1.1178 -      role="hg-cmd">hg pull</command> ne touche pas (par défaut) à l'espace
  1.1179 -      de travail. C'est la commande <command role="hg-cmd">hg update</command>
  1.1180 -      qui s'en charge.</para>
  1.1181 -
  1.1182 -     &interaction.tour.update;
  1.1183 -
  1.1184 -    <para id="x_5f">Il peut sembler un peu étrange que la commande <command
  1.1185 -      role="hg-cmd">hg pull</command> ne mette pas à jour l'espace de travail
  1.1186 -      automatiquement. Il y a en fait une très bonne raison à cela : vous
  1.1187 -      pouvez utilisez la commande <command role="hg-cmd">hg update</command>
  1.1188 -      pour mettre à jour votre espace de travail à l'état dans lequel il était 
  1.1189 -      à <emphasis>n'importe quelle révision</emphasis> de l'historique du dépôt. 
  1.1190 -      Si vous aviez un espace de travail contenant une ancienne
  1.1191 -      révision&emdash;pour chercher l'origine d'un bug, par exemple&emdash;et
  1.1192 -      que vous effectuiez un <command role="hg-cmd">hg pull</command> qui
  1.1193 -      mettrait à jour automatiquement votre espace de travail, vous ne seriez
  1.1194 -      probablement pas très satisfait.
  1.1195 -    </para>
  1.1196 -
  1.1197 -    <para id="x_60">Néanmoins, comme les opérations de pull sont très souvent
  1.1198 -      suivies d'un update, Mercurial vous permet de combiner les
  1.1199 -      deux aisément en passant l'option <option role="hg-opt-pull">-u</option> 
  1.1200 -      à la commande <command role="hg-cmd">hg pull</command>.</para>
  1.1201 -
  1.1202 -    <para id="x_61">Si vous étudiez de nouveau la sortie de la commande <command
  1.1203 -      role="hg-cmd">hg pull</command> dans la section <xref
  1.1204 -      linkend="sec:tour:pull"/> quand nous l'avons exécutée sans l'option
  1.1205 -      <option role="hg-opt-pull">-u</option>, vous pouvez constater qu'elle a
  1.1206 -      affiché un rappel assez utile : vous devez encore effectuer une
  1.1207 -      opération pour mettre à jour votre espace de travail.</para>
  1.1208 -
  1.1209 -    <para id="x_62">Pour découvrir sur quelle révision de l'espace de 
  1.1210 -      travail on se trouve, utilisez la commande <command role="hg-cmd">hg
  1.1211 -      parents</command>.</para>
  1.1212 -
  1.1213 -     &interaction.tour.parents;
  1.1214 -
  1.1215 -   <para id="x_63">Si vous regardez de nouveau le dessin <xref
  1.1216 -     linkend="fig:tour-basic:history"/>, vous verrez les flèches reliant
  1.1217 -     entre eux les révisions. Le nœud d'où la flèche
  1.1218 -     <emphasis>part</emphasis> est dans chaque cas un parent,
  1.1219 -     et le nœud où la flèche <emphasis>arrive</emphasis> est un enfant.</para>
  1.1220 -
  1.1221 -   <para id="x_64">Pour mettre à jour l'espace de travail d'une révision particulière,
  1.1222 -     indiquez un numéro de révision ou un \textit{changeset ID} à la commande
  1.1223 -     <command role="hg-cmd">hg update</command>.</para>
  1.1224 -
  1.1225 -    &interaction.tour.older;
  1.1226 -
  1.1227 -   <para id="x_65">Si vous ne précisez pas de manière explicite de numéro 
  1.1228 -     de révision la commande <command role="hg-cmd">hg update</command>
  1.1229 -     mettra à jour votre espace de travail avec
  1.1230 -     le contenu de la révsion \textit{tip}, comme montré dans l'exemple ci
  1.1231 -     dessus lors du second appel à <command role="hg-cmd">hg update</command>.</para>
  1.1232 -  </sect2>
  1.1233 -
  1.1234 -  <sect2>
  1.1235 -    <title>Transférer les modifications à un autre dépôt</title>
  1.1236 -
  1.1237 -    <para id="x_66">Mercurial vous laisse transférer les modifications 
  1.1238 -      à un autre dépôt, depuis votre dépôt actuel. Comme dans l'exemple 
  1.1239 -      du <command role="hg-cmd">hg pull</command> ci-dessus, nous allons 
  1.1240 -      créer un dépôt temporaire vers lequel transférer nos modifications.
  1.1241 -
  1.1242 -     &interaction.tour.clone-push;
  1.1243 -
  1.1244 -    <para id="x_67">La commande <command role="hg-cmd">hg outgoing</command>
  1.1245 -      nous indique quels changements nous allons transférer vers l'autre
  1.1246 -      serveur ?</para>
  1.1247 -
  1.1248 -     &interaction.tour.outgoing;
  1.1249 -
  1.1250 -    <para id="x_68">Et la commande <command role="hg-cmd">hg push</command> 
  1.1251 -      effectue réellement le transfert.</para>
  1.1252 -
  1.1253 -     &interaction.tour.push;
  1.1254 -
  1.1255 -    <para id="x_69">Comme avec <command role="hg-cmd">hg pull</command>, la
  1.1256 -      commande <command role="hg-cmd">hg push</command> ne met pas à jour
  1.1257 -      le répertoire de travail du dépôt dans lequel il transfère les
  1.1258 -      modifications. À l'inverse de <command role="hg-cmd">hg pull</command>, 
  1.1259 -      <command role="hg-cmd">hg push</command> ne fournit pas d'option 
  1.1260 -      <literal>-u</literal> pour forcer la mise à jour de l'espace de
  1.1261 -      travail cible. Cette asymétrie est délibéré : le dépot vers lequel nous
  1.1262 -      transférons peut très bien être un serveur distant et partagé par
  1.1263 -      plusieurs personnes. Si nous devions mettre à jour son répertoire de
  1.1264 -      travail alors que quelqu'un d'autre travail dessus, nous risquerions 
  1.1265 -      de perturber son travail.</para>
  1.1266 -
  1.1267 -    <para id="x_6a">Qu'est ce qui se passe lorsque vous essayez de récupérer
  1.1268 -      ou de transférer vos modifications et que le dépôt cible a déjà reçu
  1.1269 -      ces modifications ? Rien de bien excitant.</para>
  1.1270 -
  1.1271 -     &interaction.tour.push.nothing;
  1.1272 -
  1.1273 -  </sect2>
  1.1274 -
  1.1275 -  <sect2>
  1.1276 -    <title>Emplacements par défaut</title>
  1.1277 -          
  1.1278 -    <para id="x_719">Quand nous faisons un clone d'un dépôt, Mercurial
  1.1279 -      enregistre l'emplacement du dépôt d'origine dans le fichier
  1.1280 -      <filename>.hg/hgrc</filename> de notre nouveau dépôt. Si nous ne
  1.1281 -      fournissons pas d'emplacement à la commande <command>hg pull</command>
  1.1282 -      ou à la commande <command>hg push</command>, ces commandes utiliseront
  1.1283 -      alors ces emplacements comme valeur par défaut. Les commandes
  1.1284 -      <command>hg incoming</command> et <command>hg outgoing</command> feront
  1.1285 -      de même.</para>
  1.1286 -
  1.1287 -    <para id="x_71a">Si vous regardez le fichier
  1.1288 -      <filename>.hg/hgrc</filename>, vous constaterez que son contenu ressemble
  1.1289 -      à ce qui suit.</para>
  1.1290 -
  1.1291 -    <programlisting>[paths]
  1.1292 +  
  1.1293 +      <para id="x_5c">Apporter les modifications rapatriées dans un dépôt se
  1.1294 +        résume donc à exécuter la commande <command role="hg-cmd">hg
  1.1295 +          pull</command>, et préciser depuis quel dépôt effectuer le <command
  1.1296 +          role="hg-cmd">hg pull</command>.</para>
  1.1297 +      
  1.1298 +      &interaction.tour.pull;
  1.1299 +  
  1.1300 +      <para id="x_5d">Comme vous le voyez avec une sortie avant et après de la
  1.1301 +        commande <command role="hg-cmd">hg tip</command>, nous avons réussi à
  1.1302 +        récupérer aisément les modifications dans notre dépôt. Il reste néanmoins
  1.1303 +        quelque chose à faire avant de placer ces modifications dans l'espace de
  1.1304 +        travail.</para>
  1.1305 +   
  1.1306 +      <tip>
  1.1307 +        <title>Récupérer des changements précis</title>
  1.1308 +   
  1.1309 +        <para id="x_5b">Il est possible à cause du délai entre l'exécution de la
  1.1310 +          commande <command role="hg-cmd">hg incoming</command> et l'exécution de
  1.1311 +          la commande <command role="hg-cmd">hg pull</command>, que vous ne
  1.1312 +          puissiez pas voir toutes les modifications que vous rapporterez d'un
  1.1313 +          autre dépôt. Supposons que vous récupériez les modifications d'un dépôt
  1.1314 +          situé quelque part sur le réseau. Alors que vous regardez le résultat de
  1.1315 +          la commande <command role="hg-cmd">hg incoming</command>, et avant que
  1.1316 +          vous ne décidiez de récupérer ces modifications, quelqu'un peut ajouter
  1.1317 +          de nouvelles révisions dans le dépôt distant. Ce qui signifie que vous
  1.1318 +          récupérez plus de révision que ce que vous aviez regardées en utilisant
  1.1319 +          la commande <command role="hg-cmd">hg incoming</command>.</para>
  1.1320 +
  1.1321 +        <para id="x_718">Si vous voulez seulement récupérer ce que vous aviez
  1.1322 +          vérifier à l'aide de la commande <command role="hg-cmd">hg
  1.1323 +            incoming</command>, ou que pour d'autres raisons vous souhaitiez ne
  1.1324 +          récupérer qu'un sous ensemble des révisions supplémentaires
  1.1325 +          disponibles, indiquant simplement les modifications que vous souhaitez
  1.1326 +          récupérer par leurs ID de révision, soit <command>hg pull
  1.1327 +            -r7e95bb</command>. </para>
  1.1328 +      </tip>
  1.1329 +  
  1.1330 +    </sect2>
  1.1331 +    <sect2>
  1.1332 +      <title>Mise à jour de l'espace de travail</title>
  1.1333 +  
  1.1334 +      <para id="x_5e">Nous avons jusqu'à maintenant grossièrement défini la
  1.1335 +        relation entre un dépôt et un espace de travail. La commande <command
  1.1336 +          role="hg-cmd">hg pull</command> que nous avons exécutée dans la section 
  1.1337 +        <xref linkend="sec:tour:pull"/> a apporté des modifications, que nous
  1.1338 +        avons vérifiées, dans notre dépôt, mais il n'y a aucune trace de ces
  1.1339 +        modifications dans notre espace de travail. En effet, <command
  1.1340 +          role="hg-cmd">hg pull</command> ne touche pas (par défaut) à l'espace
  1.1341 +        de travail. C'est la commande <command role="hg-cmd">hg update</command>
  1.1342 +        qui s'en charge.</para>
  1.1343 + 
  1.1344 +      &interaction.tour.update;
  1.1345 +  
  1.1346 +      <para id="x_5f">Il peut sembler un peu étrange que la commande <command
  1.1347 +          role="hg-cmd">hg pull</command> ne mette pas à jour l'espace de travail
  1.1348 +        automatiquement. Il y a en fait une très bonne raison à cela : vous
  1.1349 +        pouvez utilisez la commande <command role="hg-cmd">hg update</command>
  1.1350 +        pour mettre à jour votre espace de travail à l'état dans lequel il était 
  1.1351 +        à <emphasis>n'importe quelle révision</emphasis> de l'historique du dépôt. 
  1.1352 +        Si vous aviez un espace de travail contenant une ancienne
  1.1353 +        révision&emdash;pour chercher l'origine d'un bug, par exemple&emdash;et
  1.1354 +        que vous effectuiez un <command role="hg-cmd">hg pull</command> qui
  1.1355 +        mettrait à jour automatiquement votre espace de travail, vous ne seriez
  1.1356 +        probablement pas très satisfait.</para>
  1.1357 +  
  1.1358 +      <para id="x_60">Néanmoins, comme les opérations de pull sont très souvent
  1.1359 +        suivies d'un update, Mercurial vous permet de combiner les
  1.1360 +        deux aisément en passant l'option <option role="hg-opt-pull">-u</option> 
  1.1361 +        à la commande <command role="hg-cmd">hg pull</command>.</para>
  1.1362 +  
  1.1363 +      <para id="x_61">Si vous étudiez de nouveau la sortie de la commande <command
  1.1364 +          role="hg-cmd">hg pull</command> dans la section <xref
  1.1365 +          linkend="sec:tour:pull"/> quand nous l'avons exécutée sans l'option
  1.1366 +        <option role="hg-opt-pull">-u</option>, vous pouvez constater qu'elle a
  1.1367 +        affiché un rappel assez utile : vous devez encore effectuer une
  1.1368 +        opération pour mettre à jour votre espace de travail.</para>
  1.1369 +
  1.1370 +      <para id="x_62">Pour découvrir sur quelle révision de l'espace de 
  1.1371 +        travail on se trouve, utilisez la commande <command role="hg-cmd">hg
  1.1372 +          parents</command>.</para>
  1.1373 + 
  1.1374 +      &interaction.tour.parents;
  1.1375 +   
  1.1376 +      <para id="x_63">Si vous regardez de nouveau le dessin <xref
  1.1377 +          linkend="fig:tour-basic:history"/>, vous verrez les flèches reliant
  1.1378 +        entre elles les révisions. Le nœud d'où la flèche
  1.1379 +        <emphasis>part</emphasis> est dans chaque cas un parent,
  1.1380 +        et le nœud où la flèche <emphasis>arrive</emphasis> est un
  1.1381 +        enfant.</para>
  1.1382 +
  1.1383 +      <para id="x_64">Pour mettre à jour l'espace de travail d'une révision
  1.1384 +        particulière, indiquez un numéro de révision ou un \textit{changeset
  1.1385 +        ID} à la commande <command role="hg-cmd">hg update</command>.</para>
  1.1386 +  
  1.1387 +      &interaction.tour.older;
  1.1388 +   
  1.1389 +      <para id="x_65">Si vous ne précisez pas de manière explicite de numéro 
  1.1390 +        de révision la commande <command role="hg-cmd">hg update</command>
  1.1391 +        mettra à jour votre espace de travail avec le contenu de la révison
  1.1392 +        \textit{tip}, comme montré dans l'exemple ci dessus lors du second
  1.1393 +        appel à <command role="hg-cmd">hg update</command>.</para>
  1.1394 +    
  1.1395 +    </sect2>
  1.1396 +    <sect2>
  1.1397 +      <title>Transférer les modifications vers un autre dépôt</title>
  1.1398 +  
  1.1399 +      <para id="x_66">Mercurial vous laisse transférer les modifications vers
  1.1400 +        un autre dépôt, depuis votre dépôt actuel. Comme dans l'exemple du
  1.1401 +        <command role="hg-cmd">hg pull</command> ci-dessus, nous allons créer
  1.1402 +        un dépôt temporaire vers lequel transférer nos modifications.</para>
  1.1403 +        
  1.1404 +      &interaction.tour.clone-push;
  1.1405 +  
  1.1406 +      <para id="x_67">La commande <command role="hg-cmd">hg outgoing</command>
  1.1407 +        nous indique quels changements nous allons transférer vers l'autre
  1.1408 +        serveur.</para>
  1.1409 + 
  1.1410 +      &interaction.tour.outgoing;
  1.1411 +  
  1.1412 +      <para id="x_68">Et la commande <command role="hg-cmd">hg push</command> 
  1.1413 +        effectue réellement le transfert.</para>
  1.1414 + 
  1.1415 +      &interaction.tour.push;
  1.1416 +  
  1.1417 +      <para id="x_69">Comme avec <command role="hg-cmd">hg pull</command>, la
  1.1418 +        commande <command role="hg-cmd">hg push</command> ne met pas à jour
  1.1419 +        le répertoire de travail du dépôt dans lequel il transfère les
  1.1420 +        modifications. À l'inverse de <command role="hg-cmd">hg
  1.1421 +          pull</command>, <command role="hg-cmd">hg push</command> ne fournit
  1.1422 +        pas d'option <literal>-u</literal> pour forcer la mise à jour de
  1.1423 +        l'espace de travail cible. Cette asymétrie est délibéré : le dépot
  1.1424 +        vers lequel nous transférons peut très bien être un serveur distant
  1.1425 +        et partagé par plusieurs personnes. Si nous devions mettre à jour son
  1.1426 +        répertoire de travail alors que quelqu'un d'autre travaille dessus,
  1.1427 +        nous risquerions de perturber son travail.</para>
  1.1428 +  
  1.1429 +      <para id="x_6a">Qu'est ce qui se passe lorsque vous essayez de récupérer
  1.1430 +        ou de transférer vos modifications et que le dépôt cible a déjà reçu
  1.1431 +        ces modifications ? Rien de bien excitant.</para>
  1.1432 + 
  1.1433 +      &interaction.tour.push.nothing;
  1.1434 +  
  1.1435 +    </sect2>
  1.1436 +  
  1.1437 +    <sect2>
  1.1438 +      <title>Emplacements par défaut</title>
  1.1439 +
  1.1440 +      <para id="x_719">Quand nous faisons un clone d'un dépôt, Mercurial
  1.1441 +        enregistre l'emplacement du dépôt d'origine dans le fichier
  1.1442 +        <filename>.hg/hgrc</filename> de notre nouveau dépôt. Si nous ne
  1.1443 +        fournissons pas d'emplacement à la commande <command>hg
  1.1444 +          pull</command> ou à la commande <command>hg push</command>, ces
  1.1445 +        commandes utiliseront alors cet emplacement comme valeur par défaut.
  1.1446 +        Les commandes <command>hg incoming</command> et <command>hg
  1.1447 +          outgoing</command> feront de même.</para>
  1.1448 +  
  1.1449 +      <para id="x_71a">Si vous regardez le fichier
  1.1450 +        <filename>.hg/hgrc</filename>, vous constaterez que son contenu
  1.1451 +        ressemble à ce qui suit.</para>
  1.1452 +  
  1.1453 +      <programlisting>[paths]
  1.1454  default = http://www.selenic.com/repo/hg</programlisting>
  1.1455        
  1.1456 -    <para id="x_71b">Il est possible&emdash;et souvent
  1.1457 -      pratique&emdash;d'avoir un emplacement par défaut pour la commande
  1.1458 -      <command>hg push</command> et la commande <command>hg outgoing</command>
  1.1459 -      différent de celui des commandes <command>hg pull</command> et des
  1.1460 -      <command>hg incoming</command>. C'est faisable en ajoutant une entrée
  1.1461 -      <literal>default-push</literal> à la section <literal>[paths]</literal>
  1.1462 -      du <filename>.hg/hgrc</filename>, comme suit.</para>
  1.1463 -    
  1.1464 -    <programlisting>[paths]
  1.1465 +      <para id="x_71b">Il est possible&emdash;et souvent
  1.1466 +        pratique&emdash;d'avoir un emplacement par défaut pour les commandes
  1.1467 +        <command>hg push</command> et <command>hg outgoing</command>
  1.1468 +        différent de celui des commandes <command>hg pull</command> et
  1.1469 +        <command>hg incoming</command>. C'est faisable en ajoutant une entrée
  1.1470 +        <literal>default-push</literal> à la section
  1.1471 +        <literal>[paths]</literal> du <filename>.hg/hgrc</filename>, comme
  1.1472 +        suit.</para>
  1.1473 +   
  1.1474 +      <programlisting>[paths]
  1.1475  default = http://www.selenic.com/repo/hg
  1.1476  default-push = http://hg.example.com/hg</programlisting>
  1.1477 -  </sect2>
  1.1478 -
  1.1479 -  <sect2>
  1.1480 -    <title>Partager ses modifications à travers le réseau</title>
  1.1481 -
  1.1482 -    <para id="x_6b">Les commandes que nous avons étudiées dans les sections
  1.1483 -      précédentes ne sont pas limitées aux dépôt locaux. Chacune fonctionne 
  1.1484 -      de la même manière à travers une connexion réseau, il suffit de lui 
  1.1485 -      passer une URL à la place d'un chemin de fichier local.</para>
  1.1486 -
  1.1487 -     &interaction.tour.outgoing.net;
  1.1488 -
  1.1489 -    <para id="x_6c">Dans cet exemple, nous allons voir quels changements 
  1.1490 -      nous pourrions transférer vers le dépôt distant, mais le dépôt est, 
  1.1491 -      de manière tout à fait compréhensible, pas configuré pour accepter 
  1.1492 -      des modifications d'utilisateurs anonymes.</para>
  1.1493 -
  1.1494 -     &interaction.tour.push.net; 
  1.1495 -    </sect2>
  1.1496 +
  1.1497 +    </sect2>
  1.1498 +    <sect2>
  1.1499 +      <title>Partager ses modifications à travers le réseau</title>
  1.1500 +  
  1.1501 +      <para id="x_6b">Les commandes que nous avons étudiées dans les sections
  1.1502 +        précédentes ne sont pas limitées aux dépôts locaux. Chacune fonctionne 
  1.1503 +        de la même manière à travers une connexion réseau, il suffit de lui 
  1.1504 +        passer une URL à la place d'un chemin de fichier local.</para>
  1.1505 + 
  1.1506 +      &interaction.tour.outgoing.net;
  1.1507 +  
  1.1508 +      <para id="x_6c">Dans cet exemple, nous allons voir quels changements 
  1.1509 +        nous pourrions transférer vers le dépôt distant, mais le dépôt est, 
  1.1510 +        de manière tout à fait compréhensible, pas configuré pour accepter 
  1.1511 +        des modifications d'utilisateurs anonymes.</para>
  1.1512 + 
  1.1513 +      &interaction.tour.push.net; 
  1.1514 +    
  1.1515 +    </sect2>
  1.1516 +
  1.1517    </sect1>
  1.1518  
  1.1519    <sect1>
  1.1520 -    <title>Commencer un nouveau projet</title>w
  1.1521 -    
  1.1522 -      <para id="x_71c">Il est tout aussi aisé de commencer un nouveau projet
  1.1523 -        que de travailler sur un qui existe déjà. La commande
  1.1524 -        <command>hg init</command> créer un nouveau dépôt Mercurial,
  1.1525 -        vide.</para>
  1.1526 -      
  1.1527 -       &interaction.ch01-new.init;
  1.1528 -                        
  1.1529 -      <para id="x_71d">Ceci créer simplement un répertoire nommée
  1.1530 -        <filename>myproject</filename> dans le répertoire courant.</para>
  1.1531 -
  1.1532 -       &interaction.ch01-new.ls;
  1.1533 -
  1.1534 -      <para id="x_71e">Nous pouvons dire que <filename>myproject</filename>
  1.1535 -        est un dépôt Mercurial car il contient un répertoire
  1.1536 -        <filename>.hg</filename>.</para>
  1.1537 -
  1.1538 -       &interaction.ch01-new.ls2;
  1.1539 -      
  1.1540 -      <para id="x_71f">Si vous voulons ajouter quelques fichiers préexistants
  1.1541 -        dans ce dépôt, il suffit de les recopier dans le répertoire de travail,
  1.1542 -        et demander à Mercurial de commencer les suivre en utilisant la
  1.1543 -        commande <command>hg add</command>.</para>
  1.1544 -
  1.1545 -      &interaction.ch01-new.add;
  1.1546 -
  1.1547 -      <para id="x_720">Une fois que nous sommes satisfait de notre projet,
  1.1548 -        nous pouvons commencer à ajouter nos révisions.</para>
  1.1549 -
  1.1550 -       &interaction.ch01-new.commit;
  1.1551 -
  1.1552 -      <para id="x_721">Il ne prend que quelques instants pour commencer à
  1.1553 +    <title>Commencer un nouveau projet</title>
  1.1554 +
  1.1555 +    <para id="x_71c">Il est tout aussi aisé de commencer un nouveau projet
  1.1556 +      que de travailler sur un qui existe déjà. La commande <command>hg
  1.1557 +        init</command> crée un nouveau dépôt Mercurial vide.</para>
  1.1558 +
  1.1559 +    &interaction.ch01-new.init;
  1.1560 +
  1.1561 +    <para id="x_71d">Ceci crée simplement un répertoire nommé
  1.1562 +      <filename>myproject</filename> dans le répertoire courant.</para>
  1.1563 +
  1.1564 +    &interaction.ch01-new.ls;
  1.1565 +
  1.1566 +    <para id="x_71e">Nous pouvons dire que <filename>myproject</filename> est
  1.1567 +      un dépôt Mercurial car il contient un répertoire
  1.1568 +      <filename>.hg</filename>.</para>
  1.1569 +
  1.1570 +    &interaction.ch01-new.ls2;
  1.1571 +
  1.1572 +    <para id="x_71f">Si vous voulons ajouter quelques fichiers préexistants
  1.1573 +      dans ce dépôt, il suffit de les recopier dans le répertoire de travail,
  1.1574 +      et demander à Mercurial de commencer à les suivre en utilisant la
  1.1575 +      commande <command>hg add</command>.</para>
  1.1576 +
  1.1577 +    &interaction.ch01-new.add;
  1.1578 +
  1.1579 +    <para id="x_720">Une fois que nous sommes satisfaits de notre projet,
  1.1580 +      nous pouvons commencer à ajouter nos révisions.</para>
  1.1581 +
  1.1582 +    &interaction.ch01-new.commit;
  1.1583 +
  1.1584 +    <para id="x_721">Il ne prend que quelques instants pour commencer à
  1.1585        utiliser Mercurial sur un nouveau projet, ce qui fait aussi de ses
  1.1586        points forts. Travailler avec une gestion de révision devient très
  1.1587        facile, nous pouvons même l'utiliser pour les plus petits projets où
  1.1588        nous aurions probablement jamais penser utiliser un outils aussi
  1.1589        complexe.</para>
  1.1590 -   </sect1>
  1.1591 +  </sect1>
  1.1592  </chapter>
  1.1593  
  1.1594  <!--