belaran@964: <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
belaran@964: 
belaran@973: <chapter id="chap:tour-basic">
belaran@973:   <?dbhtml filename="a-tour-of-mercurial-the-basics.html"?>
belaran@973:   <title>Une rapide présentation de Mercurial : les bases</title>
belaran@973: 
belaran@973:   <sect1>
belaran@973:     <title>Installer Mercurial sur votre système</title>
belaran@973: 
youshe@983:     <para id="x_1">Des paquetages binaires de Mercurial sont disponibles pour la
youshe@983:       plupart des systèmes d'exploitation, ce qui rend facile l'utilisation
youshe@983:       immédiate de Mercurial sur votre ordinateur.</para>
belaran@964: 
belaran@973:     <sect2>
belaran@973:       <title>Windows</title>
belaran@973: 
wilk@1005:       <para id="x_c">La meilleure version de Mercurial pour Windows est
youshe@983:         TortoiseHg, qui peut être téléchargée ici : <ulink
youshe@983:           url="http://bitbucket.org/tortoisehg/stable/wiki/Home">http://bitbucket.org/tortoisehg/stable/wiki/Home</ulink>.
andre@1015:         Ce logiciel n'a aucune dépendance exterieure ; il fonctionne <quote>et
youshe@983:           c'est tout</quote>. Il fournit aussi bien les outils en ligne de
youshe@983:         commmande qu'une interface graphique.</para>
youshe@983:  
youshe@983:     </sect2>
youshe@983: 
youshe@983:     <sect2>
youshe@983:       <title>Mac OS X</title>
youshe@983:   
youshe@983:       <para id="x_a">Lee Cantey publie un installeur de Mercurial pour Mac OS
youshe@983:         X sur <ulink
youshe@983:           url="http://mercurial.berkwood.com">http://mercurial.berkwood.com</ulink>.</para>
youshe@983:     </sect2>
youshe@983:       
youshe@983:     <sect2>
youshe@983:       <title>Linux</title>
youshe@983: 
youshe@983:       <para id="x_2">Parce que chaque distribution de Linux a ses propres
youshe@983:         outils de gestion de paquets, politiques et rythmes de
youshe@983:         développements, il est difficile de donner un ensemble
youshe@983:         d'instructions unique pour installer les binaires de Mercurial. La
youshe@983:         version de Mercurial avec laquelle vous vous retrouverez dépendra
youshe@983:         grandement de l'activité de la personne en charge du paquetage pour
youshe@983:         la distribution.</para>
youshe@983: 
youshe@983:       <para id="x_3">Pour rester simple, je me concentrerai sur
youshe@983:         l'installation de Mercurial en ligne de commande, sous les
youshe@983:         distributions les plus courantes. La plupart des distributions
youshe@983:         fournissent des gestionnaires graphiques de paquetage qui vous
youshe@983:         permettront d'installer Mercurial en quelques clicks. Le paquetage
youshe@983:         devrait se nommer <literal>mercurial</literal>.</para>
youshe@983: 
youshe@983:       <itemizedlist>
andre@1015:         <listitem><para id="x_4">Ubuntu et Debian :</para>
belaran@997:           <programlisting>apt-get install mercurial</programlisting></listitem>
andre@1015:         <listitem><para id="x_5">Fedora :</para>
belaran@997:           <programlisting>yum install mercurial</programlisting></listitem>
andre@1015:         <listitem><para id="x_6">Gentoo :</para>
youshe@983:            <programlisting>emerge mercurial</programlisting></listitem>
andre@1015:         <listitem><para id="x_715">OpenSUSE :</para>
belaran@997:           <programlisting>zypper install
belaran@997:           mercurial</programlisting></listitem>
youshe@983:       </itemizedlist>
youshe@983: 
youshe@983:     </sect2>
youshe@983:     <sect2>
youshe@983:       <title>Solaris</title>
youshe@983: 
youshe@983:       <para id="x_09">SunFreeWare, à <ulink 
youshe@983:       url="http://www.sunfreeware.com">http://www.sunfreeware.com</ulink>,
youshe@983:       fournit des paquets précompilés pour Mercurial.</para>
youshe@983:     </sect2>
youshe@983:   </sect1>
belaran@973: 
belaran@973:   <sect1>
belaran@973:     <title>Commencer à utiliser Mercurial</title>
belaran@973: 
youshe@983:     <para id="x_e">Pour commencer, nous utiliserons la commande <command
youshe@983:         role="hg-cmd">hg version</command> pour vérifier si Mercurial est
andre@1015:       installé proprement. L'information de version affichée n'est
andre@1015:       pas réellement importante en soi, c'est surtout de savoir si elles
youshe@983:       s'affichent qui nous intéresse.</para>
youshe@983: 
youshe@983:     &interaction.tour.version;
youshe@983: 
youshe@983:     <sect2>
youshe@983:       <title>L'aide intégrée</title>
youshe@983: 
belaran@997:       <para id="x_f">Mercurial fournit un système d'aide intégré, ce qui est
youshe@983:         inestimable quand vous vous retrouvez coincé à essayer de vous
youshe@983:         rappeler comment lancer une commande. Si vous êtes bloqué, exécutez
andre@1015:         simplement <command role="hg-cmd">hg help</command> ; elle affichera
youshe@983:         une brève liste des commandes, avec une description pour chacune. Si
youshe@983:         vous demandez de l'aide sur une commande spécifique (voir
youshe@983:         ci-dessous), elle affichera des informations plus détaillées.</para>
youshe@983: 
youshe@983:       &interaction.tour.help;
youshe@983: 
youshe@983:       <para id="x_10">Pour un niveau d'informations encore plus détaillé 
wilk@1005:         (ce dont vous aurez rarement besoin), exécutez <command role="hg-cmd">hg 
belaran@973:         help <option role="hg-opt-global">-v</option></command>.  L'option 
belaran@973:         <option role="hg-opt-global">-v</option> est l'abréviation de 
belaran@973:         <option role="hg-opt-global">--verbose</option>, et indique à Mercurial 
wilk@1005:         d'afficher plus d'informations que d'habitude.</para>
belaran@973: 
belaran@973:      </sect2>
belaran@973:   </sect1>
belaran@973:   <sect1>
belaran@973:     <title>Travailler avec un dépôt</title>
belaran@973: 
wilk@1005:     <para id="x_11">Avec Mercurial, tout se déroule au sein d'un 
belaran@973:       <emphasis>dépôt</emphasis>. Le dépôt d'un projet contient tous 
belaran@973:       les fichiers qui <quote>appartiennent</quote> au projet.</para>
belaran@973: 
belaran@973:     <para id="x_12">Il n'y a rien de particulièrement magique au sujet de 
belaran@973:       ce dépôt, c'est simplement une arborescence sur votre système de fichiers 
youshe@983:       que Mercurial traite de manière spéciale. Vous pouvez renommer ou effacer 
andre@1015:       ce répertoire à n'importe quel moment, en utilisant la ligne de commande 
belaran@973:       ou votre explorateur de fichiers.</para>
belaran@973: 
belaran@973:     <sect2>
belaran@973:       <title>Faire une copie locale de votre dépôt</title>
belaran@973:       
belaran@973:       <para id="x_13"><emphasis>Copier</emphasis> un dépôt est juste un 
belaran@973:         peu spécial. Bien que vous puissiez utiliser une commande habituelle de 
belaran@973:         copie pour copier votre dépôt, il vaut mieux utiliser une commande fournie par
belaran@973:         Mercurial. Cette commande est appelée <command role="hg-cmd">hg clone</command>, 
belaran@973:         car elle crée une copie identique à un dépôt existant.</para>
belaran@973: 
youshe@983:       &interaction.tour.clone;
youshe@983: 
youshe@983:       <para id="x_67c">Un avantage de la commande <command role="hg-cmd">hg
youshe@983:           clone</command> est que, comme nous l'avons vu ci dessus, elle nous
wilk@1005:         permet de cloner les dépôts à travers le réseau. Un autre
youshe@983:         est qu'elle se rappelle d'où a été cloné un dépôt, ce qui est utile
youshe@983:         quand on veut mettre à jour le clone.</para>
youshe@983: 
youshe@983:       <para id="x_14">Si votre opération de clonage réussit, vous devriez maintenant
belaran@973:         avoir un répertoire local appelé <filename class="directory">hello</filename>. 
belaran@973:         Ce répertoire contiendra quelques fichiers.</para>
belaran@973: 
youshe@983:       &interaction.tour.ls;
youshe@983: 
youshe@983:       <para id="x_15">Ces fichiers ont le même contenu et historique dans votre dépôt
youshe@983:         qu'ils ont dans le dépôt que vous avez cloné.</para>
youshe@983: 
youshe@983:       <para id="x_16">Chaque dépôt Mercurial est complet, autonome et
youshe@983:         indépendant. Il contient sa propre copie privée des fichiers du
youshe@983:         projet et de leur historique. Le clone d'un dépôt se souvient de la
andre@1015:         localisation du dépôt à partir duquel il a été cloné, mais il ne
youshe@983:         communique pas avec ce dernier, ou un autre, à moins que vous ne lui
youshe@983:         demandiez.</para>
youshe@983: 
andre@1015:       <para id="x_17">Tout ceci signifie pour le moment que nous
youshe@983:         sommes libres d'expérimenter avec ce dépôt, confiants dans le fait
youshe@983:         qu'il s'agit d'un <quote>bac à sable</quote> qui n'affectera personne
youshe@983:         d'autre.</para>
belaran@973: 
belaran@973:     </sect2>  
belaran@973:     <sect2>
belaran@973:       <title>Quel est le contenu d'un dépôt ?</title>
belaran@973: 
belaran@973:       <para id="x_18">Prêtons plus attention un instant au contenu d'un dépôt. 
belaran@973:         Nous voyons qu'il contient un répertoire nommé <filename class="directory">.hg
belaran@973:         </filename>. C'est ici que Mercurial conserve toutes ses
belaran@973:         métadonnées.</para>
belaran@973: 
youshe@983:       &interaction.tour.ls-a; 
belaran@973: 
belaran@973:       <para id="x_19">Le contenu du répertoire <filename class="directory">.hg
andre@1015:         </filename> et ses sous-répertoires sont les seuls propres à Mercurial. 
belaran@973:         Tous les autres fichiers et répertoires dans le dépôt sont à vous, et 
belaran@973:         vous pouvez en faire ce que vous voulez.</para>
belaran@973: 
belaran@973:       <para id="x_1a">Pour introduire un peu de terminologie, le répertoire 
belaran@973:         <filename class="directory">.hg</filename> est un <quote>vrai</quote> 
belaran@973:         dépôt, et tous les fichiers et les répertoires qui coexistent avec lui, 
belaran@973:         sont désignés sous le nom <emphasis>espace de travail</emphasis>. Une 
belaran@973:         manière facile de se rappeler cette distinction est de retenir que le 
belaran@973:         <emphasis>dépôt</emphasis> contient l'<emphasis>historique</emphasis>
belaran@973:         de votre projet, alors que l'<emphasis>espace de travail</emphasis> 
belaran@973:         contient un "<emphasis>snapshot</emphasis>"  de votre projet à un certain 
belaran@973:         point de son historique.</para>
belaran@973: 
belaran@973:     </sect2>
belaran@973:   </sect1>
belaran@973:   <sect1>
belaran@973:     <title>Une promenade dans l'historique</title>
belaran@973: 
belaran@973:     <para id="x_1b">Une des premières choses que vous aurez envie 
belaran@973:       de faire avec un nouveau dépôt, sera de comprendre son historique. 
belaran@973:       La commande <command role="hg-cmd">hg log</command> vous donne une 
belaran@973:       vue de l'historique.</para>
belaran@973: 
youshe@983:     &interaction.tour.log;
belaran@973: 
belaran@997:     <para id="x_1c">Par défaut, cette commande affiche à l'écran un bref paragraphe pour chaque
belaran@973:       révision enregistrée pour ce projet. Dans la terminologie de Mercurial, nous
belaran@973:       appelons chacun de ces évènements enregistrés un <emphasis>changeset</emphasis>, parce
belaran@973:       qu'il contient un ensemble de modifications sur plusieurs fichiers.</para>
belaran@973: 
belaran@973:     <para id="x_1d">La commande <command role="hg-cmd">hg log</command> affiche 
youshe@983:     ainsi ces informations :</para>
belaran@973: 
belaran@973:     <itemizedlist>
youshe@983:       <listitem><para id="x_1e"><literal>changeset</literal> : Ce champ contient 
belaran@973:         un nombre, séparé par deux points (:), d'une chaine hexadécimale. Il 
wilk@1005:         s'agit en fait d'<emphasis>identifiants</emphasis>  d'un <quote>changeset</quote>. Il y a 
wilk@1005:         deux identifiants car le numéro de la révision est plus court et plus 
belaran@973:         facile à saisir qu'une séquence hexadécimale.</para>
belaran@973:       </listitem>
youshe@983:       <listitem><para id="x_1f"><literal>user</literal> : L'identité de la personne 
wilk@1005:           qui a créé ce <!--ntd %%% laisser le terme anglais car il sera affiché-->
wilk@1005:           <quote>changeset</quote>. C'est un champ libre de forme, mais la plupart du
belaran@973:         temps il contient le nom et l'email de la personne.</para>
belaran@973:       </listitem>
youshe@983:       <listitem><para id="x_20"><literal>date</literal> : La date et l'heure à 
wilk@1005:               laquelle le <quote>changeset</quote> a été créé, ainsi que le fuseau horaire dans 
youshe@983:         lequelle il a été créé. (La date et l'heure sont locales à ce
wilk@1005:         <quote>fuseau</quote>, elles indiquent donc quelle date et heure il était
andre@1015:         pour la personne qui a créé ce <quote>changeset</quote>.)</para>
belaran@973:       </listitem>
andre@1015:       <listitem><para id="x_21"><literal>summary</literal>: La première ligne du 
wilk@1005:               message que le créateur a associé à son <quote>changeset</quote> pour le décrire.</para>
belaran@973:       </listitem>
wilk@1005:       <listitem><para id="x_67d">Certains <quote>changesets</quote>, comme le premier de la
youshe@983:         liste ci-dessus ont un champ <literal>tag</literal>. Le tag est une autre
youshe@983:         façon d'identifier un changeset en lui donnant un nom simple à retenir.
youshe@983:         (Le tag nommé <literal>tip</literal> est spécial : il fait toujours
andre@1015:         référence au dernier changement dans le dépôt.)</para></listitem>
belaran@973:     </itemizedlist>
belaran@973: 
belaran@973:     <para id="x_22">Par défaut, la commande <command role="hg-cmd">hg log</command> 
youshe@983:       n'affiche qu'un résumé, il manque beaucoup de détails.</para>
belaran@973: 
belaran@973:     <para id="x_23">La figure <xref linkend="fig:tour-basic:history"/> fournit une 
belaran@973:       représentation graphique de l'historique du dépôt <filename class="directory">hello
wilk@1005:       </filename>, pour voir plus facilement dans quelle direction 
belaran@973:       l'historique se <quote>déroule</quote>. Nous reviendrons régulièrement 
belaran@973:       sur cette représentation dans ce chapitre et ceux qui suivent.</para>
belaran@973: 
belaran@973: 
belaran@973:     <figure id="fig:tour-basic:history">
wilk@1005:       <title>Historique graphique du dépôt <filename
wilk@1005:                     class="directory">hello</filename></title>
belaran@973:       <mediaobject>
belaran@973:         <imageobject><imagedata fileref="figs/tour-history.png"/></imageobject>
belaran@973:         <textobject><phrase>XXX add text</phrase></textobject>
belaran@973:       </mediaobject>
belaran@973:     </figure>
belaran@973: 
belaran@973: 
belaran@973:     <sect2>
belaran@973:       <title>Changesets, révisions, et collaboration</title>
belaran@973:       
youshe@983:       <para id="x_25">Comme l'anglais est réputé pour être un langage maladroit,
youshe@983:         et que l'informatique est la source de bien des erreurs de terminologie
youshe@983:         (pourquoi utiliser un seul terme quand quatre feront l'affaire ?), la
wilk@1005:         gestion de révisions a une variété de mots et de phrases qui veulent dire
youshe@983:         la même chose. Si vous discutez d'historique de Mercurial avec d'autres
youshe@983:         personnes, vous constaterez que souvent, le mot <quote>changeset</quote>
youshe@983:         est contracté simplement en <quote>change</quote> ou (à l'écrit)
wilk@1005:         <quote>cset</quote>, et même parfois 
youshe@983:         <quote>révision</quote>, abrégé en <quote>rev</quote>.</para>
belaran@973: 
belaran@973:       <para id="x_26">Bien que le <emphasis>mot</emphasis> que vous utilisez pour 
belaran@973:         désigner le concept de changeset importe peu, l'<emphasis>identifiant</emphasis> 
belaran@973:         que vous utilisez pour désigner un <emphasis>changeset</emphasis> spécifique 
wilk@1005:         a une grande importance. Rappelez vous que le champ <quote>changeset</quote> affiché par la
wilk@1005:         commande <command role="hg-cmd">hg log</command> identifie un <quote>changeset</quote> à
youshe@983:         la fois avec un numéro de révision et une séquence hexadécimale.</para>
belaran@973: 
belaran@973:       <itemizedlist>
belaran@973:         <listitem><para id="x_27">Le numéro de révision est <emphasis>seulement 
belaran@973:         valable dans ce dépôt</emphasis>,</para></listitem>
belaran@973:         <listitem><para id="x_28">La séquence hexadécimale est un
belaran@973:         <emphasis>identifiant permanent, et invariant</emphasis> qui 
wilk@1005:         pourra toujours être associé au <quote>changeset</quote> exact de <emphasis>chaque</emphasis> 
belaran@973:         copie de votre dépôt.</para></listitem></itemizedlist>
belaran@973: 
youshe@983:       <para id="x_29">La distinction est importante. Si vous envoyez un email 
youshe@983:          à quelqu'un en parlant de la <quote>révision 33</quote>, il est très 
wilk@1005:          probable que sa <quote>révision 33</quote> <emphasis>ne sera pas la même</emphasis> 
youshe@983:          que la votre. La raison de ceci est que le numéro de révision dépend 
youshe@983:          de l'ordre dans lequel les modifications sont arrivées dans le dépôt, 
youshe@983:          et il n'y a aucune garantie que les mêmes changements soient arrivés 
youshe@983:          dans le même ordre dans différents dépôts. Trois modifications
wilk@1005:          <literal>a, b, c</literal> peuvent aisément apparaitre dans un dépôt 
wilk@1005:          comme <literal>0, 1, 2</literal>, et dans un autre comme <literal>0, 2, 1
youshe@983:          </literal>.</para>
youshe@983: 
youshe@983:       <para id="x_2a">Mercurial utilise les numéros de révision uniquement comme des raccourcis
wilk@1005:           pratiques. Si vous devez discuter d'un <quote>changeset</quote> avec quelqu'un,
wilk@1005:           ou identifer un <quote>changeset</quote> pour une quelconque raison (par exemple,
wilk@1005:           un rapport de <quote>bug</quote>), utilisez la séquence hexadécimale.</para>
belaran@973: 
belaran@973:     </sect2>
belaran@973:     <sect2>
belaran@973:       <title>Afficher une révision spécifique</title>
belaran@973: 
belaran@973:       <para id="x_2b">Pour réduire la sortie de <command role="hg-cmd">hg log
belaran@973:         </command> à une seule révision, utilisez l'option <option role="hg-opt-log">-r
belaran@973:         </option> (ou <option role="hg-opt-log">--rev</option>). Vous pouvez utiliser
belaran@973:         le numéro de révision ou la séquence hexadécimale comme identifiant, et
belaran@973:         demander autant de révisions que vous le souhaitez.</para>
belaran@973: 
belaran@973:       &interaction.tour.log-r;
belaran@973: 
youshe@983:       <para id="x_2c">Si vous voulez voir l'historique de plusieurs révisions
wilk@1005:         sans avoir à les énumérer, vous pouvez utiliser un <emphasis>intervalle
youshe@983:         de numérotation</emphasis> qui vous permet d'exprimer l'idée <quote>je
andre@1015:         veux toutes les révisions entre <literal>abc</literal> et <literal>def</literal>
andre@1015:         inclus</quote>.</para>
youshe@983: 
youshe@983:       &interaction.tour.log.range;
youshe@983: 
youshe@983:       <para id="x_2d">Mercurial respecte aussi l'ordre dans lequel vous spécifiez
youshe@983:         les révisions, ainsi <command role="hg-cmd">hg log -r 2:4</command>
wilk@1005:         affichera <literal>2, 3, 4</literal> alors que <command role="hg-cmd">hg
wilk@1005:         log -r 4:2</command> affichera <literal>4, 3, 2</literal>.</para>
belaran@973: 
belaran@973:     </sect2>  
belaran@973:     <sect2>
belaran@973:       <title>Informations détaillées</title>
belaran@973: 
belaran@973:       <para id="x_2e">Le résumé affiché par <command role="hg-cmd">hg log</command> 
belaran@973:         est suffisant si vous savez déjà ce que vous cherchez. En 
belaran@973:         revanche, vous aurez probablement besoin de voir une description 
belaran@973:         complète du changement, ou une liste des fichiers modifiés si vous 
wilk@1005:         cherchez à déterminer qu'un <quote>changeset</quote> est bien celui que vous
wilk@1005:         recherchez. L'option <option role="hg-opt-log">-v</option> de la commande <command role="hg-cmd">hg 
belaran@973:         log</command> (ou <option role="hp-opt-global">--verbose</option>) vous 
belaran@973:         donne ces informations supplémentaires.</para>
belaran@973: 
youshe@983:       &interaction.tour.log-v;
belaran@973: 
belaran@973:       <para id="x_2f">Si vous voulez voir à la fois la description 
wilk@1005:         et le contenu d'une modification, ajoutez l'option <option 
belaran@973:         role="hg-opt-log">-p</option> (ou <option role="hg-opt-log">
belaran@973:         --patch</option>). Ceci affiche le contenu d'une modification 
belaran@973:         comme un <emphasis>diff unifié</emphasis>
belaran@973:         <!-- \footnote{NdT: \textit{unified diff}} -->
belaran@973:         (si vous n'avez jamais vu de diff unifié avant, consultez la 
belaran@973:         section <xref linkend="sec:mq:patch"/> pour un rapide 
belaran@973:         survol).</para>
belaran@973: 
belaran@973:       &interaction.tour.log-vp;
belaran@973: 
youshe@983:       <para id="x_67e">L'option <option role="hg-opt-log">-p</option> est
andre@1015:         incroyablement utile, il est donc important dans s'en rappeler.</para>
belaran@973: 
belaran@973:     </sect2>
belaran@973:   </sect1>
belaran@973:   <sect1>
belaran@973:     <title>Tout sur les options de commandes</title>
belaran@973:     
belaran@973:     <para id="x_30">Avant d'aller plus loin sur le fonctionnement 
belaran@973:       des commandes de Mercurial, étudions un moment comment elles 
belaran@973:       fonctionnent de manière générale. Vous trouverez ça probablement 
belaran@973:       utile pour la suite de notre parcours.</para>
belaran@973: 
belaran@973:     <para id="x_31">Mercurial utilise une approche directe et cohérente 
youshe@983:       pour interpréter les options que vous passez aux commandes. Il suit une
youshe@983:       convention commune à la plupart des systèmes Unix et Linux modernes.</para>
belaran@973: 
belaran@973:     <itemizedlist>
belaran@973:       <listitem><para id="x_32">Chaque option a un nom complet. Par exemple, 
belaran@973:         comme nous l'avons déjà vu, la commande <command role="hg-cmd">hg 
belaran@973:         log</command> accepte l'option <option role="hg-opt-log">--rev
belaran@973:         </option>.</para>
belaran@973:       </listitem>
belaran@973:       <listitem><para id="x_33">La plupart des options disposent de 
belaran@973:         noms abrégés. Aussi, au lieu d'utiliser <option role="hg-opt-log">--rev
belaran@973:         </option>, vous pouvez utiliser <option role="hg-opt-log">-r</option>. 
wilk@1005:         (Les options qui n'ont pas de nom abrégé sont généralement 
belaran@973:         rarement utilisées).</para>
belaran@973:       </listitem>
belaran@973:       <listitem><para id="x_34">Les noms complets commencent par deux 
andre@1015:         tirets (par exemple <option role="hg-opt-log">--rev</option>),
andre@1015:         alors que les options courtes commencent avec un seul (par exemple 
belaran@973:         <option role="hg-opt-log">-r</option>).</para>
belaran@973:       </listitem>
belaran@973:      <listitem><para id="x_35">Les noms des options sont cohérents 
belaran@973:        entre les commandes. Par exemple, chaque commande qui accepte 
wilk@1005:        un <quote>changeset ID</quote> ou un numéro de révision accepte aussi <option 
belaran@973:        role="hg-opt-log">-r</option> et <option role="hg-opt-log">--rev
belaran@973:        </option> comme arguments.</para>
belaran@973:      </listitem>
belaran@973:    </itemizedlist>
belaran@973: 
belaran@973:    <para id="x_36">Dans les exemples de ce livre, j'utilise les noms abrégés 
belaran@973:      plutôt que les noms complets. Ceci est une préférence personnelle, pas 
belaran@973:      une recommandation.</para>
belaran@973: 
belaran@973:    <para id="x_37">La plupart des commandes qui affichent une quelconque sortie 
belaran@973:      à l'écran, afficheront davantage avec l'option <option role="hg-opt-global">
belaran@973:      -v</option> (ou <option role="hg-opt-global">--verbose</option>), et
belaran@973:      moins avec l'option <option role="hg-opt-global">-q</option> (ou 
belaran@973:      <option role="hg-opt-global">--quiet</option>).</para>
belaran@973: 
belaran@973:     <note>
wilk@1005:       <title>Cohérence dans le nom des options</title>
belaran@973:       
youshe@983:       <para id="x_680">Presque toujours, les commandes de Mercurial utilisent
wilk@1005:       des noms d'options cohérentes pour se référer à des concepts identiques.
wilk@1005:       Par exemple, si une commande concerne les <quote>changesets</quote>, vous les
youshe@983:       identifierez toujours avec l'option <option role="hg-opt-log">-r</option>.
youshe@983:       Cette utilisation cohérente des noms d'options permet de mémoriser plus
wilk@1005:       facilement quelles options acceptent une commande.</para>
belaran@973:    </note>
belaran@973: 
belaran@973: 
belaran@973:   </sect1>
belaran@973:   <sect1>
belaran@973:     <title>Faire et vérifier des modifications</title>
belaran@973: 
belaran@973:     <para id="x_38">Maintenant que nous avons une bonne idée des 
belaran@973:       commandes pour consulter l'historique de Mercurial, regardons 
belaran@973:       comment faire des modifications et les examiner.</para>
belaran@973:      
wilk@1005:     <para id="x_39">La première chose que nous allons faire est d'isoler notre
wilk@1005:       exercice dans un dépôt à part. Nous allons utiliser la commande <command
youshe@983:         role="hg-cmd">hg clone</command>, mais nous n'avons pas besoin de faire
youshe@983:       une copie de dépôt distant. Comme nous avons déjà une copie locale, nous
youshe@983:       pouvons juste faire un clone de celle-ci à la place. C'est beaucoup plus
youshe@983:       rapide que de faire une copie à travers le réseau, et un dépôt cloné
youshe@983:       localement prend également moins d'espace disque<footnote>
youshe@983:       <para id="x_681">L'économie d'espace disque apparait clairement quand les
youshe@983:         dépôts source et destination sont sur le même système de fichier, où, dans
youshe@983:         ce cas, Mercurial utilisera des liens physiques pour effectuer des partages
youshe@983:         copie-lors-des-écritures de ses métadonnées internes. Si cette explication
andre@1015:         ne signifie rien pour vous, ne vous inquiétez pas : tout ceci se passe de
wilk@1005:         manière transparente et automatique. Vous n'avez pas du tout besoin de
youshe@983:         comprendre ceci.</para></footnote>.</para>
youshe@983:   
youshe@983:     &interaction.tour.reclone;
youshe@983: 
youshe@983:     <para id="x_3a">On notera au passage qu'il est souvent considéré comme
youshe@983:       une bonne pratique de conserver une copie <quote>immaculée</quote>
youshe@983:       du dépôt distant, à partir de laquelle vous pourrez faire des 
youshe@983:       copies locales temporaires pour créer des <quote>bacs à sable</quote> 
youshe@983:       pour chaque tâche sur laquelle vous souhaitez travailler. Ceci 
youshe@983:       vous permet de travailler sur plusieurs choses en parallèle, 
wilk@1005:       chacunes isolées les unes des autres en attendant que ces tâches 
youshe@983:       soient finies et que vous soyez prêt à les réintégrer. Parce 
youshe@983:       que les copies locales sont peu coûteuses, il est très rapide 
youshe@983:       de créer ou détruire des dépôts dès que vous n'en avez plus
youshe@983:       besoin.</para>
youshe@983: 
youshe@983:     <para id="x_3b">Dans notre dépôt <filename
youshe@983:         class="directory">my-hello</filename>, nous avons un fichier
youshe@983:       <filename>hello.c</filename> qui contient le classique <quote>hello,
youshe@983:         world</quote>.</para>
youshe@983:    
youshe@983:     &interaction.tour.cat1;
youshe@983: 
andre@1015:     <para id="x_682">Éditons ce fichier pour qu'il affiche une autre ligne
youshe@983:       sur la sortie standard.</para>
youshe@983:     
youshe@983:     &interaction.tour.cat2;
youshe@983: 
youshe@983:     <para id="x_3c">La commande Mercurial <command role="hg-cmd">hg
youshe@983:         status</command> nous dira ce que Mercurial sait des fichiers du
youshe@983:       dépôts.</para>
youshe@983: 
youshe@983:     &interaction.tour.status;
youshe@983: 
youshe@983:     <para id="x_3d">La commande <command role="hg-cmd">hg status</command>
youshe@983:       n'affichera pas le contenu des fichiers, mais une ligne commençant par
youshe@983:       <quote><literal>M</literal></quote> pour <filename>hello.c</filename>.
andre@1015:       À moins que vous lui demandiez, la commande <command role="hg-cmd">hg
youshe@983:         status</command> n'affichera aucune information sur les fichiers que
youshe@983:       vous n'avez pas modifiés.</para>
youshe@983:  
belaran@997:     <para id="x_3e">Le <quote><literal>M</literal></quote> indique que
youshe@983:       Mercurial a remarqué que nous avons modifié le fichier
youshe@983:       <filename>hello.c</filename>. Nous n'avons pas besoin
youshe@983:       <emphasis>d'informer</emphasis> Mercurial que nous allons modifier un
youshe@983:       fichier avant de commencer à le faire, ou que nous avons modifié un
wilk@1005:       fichier après avoir commencé à le faire, il est capable de le découvrir
wilk@1005:       tout seul.</para>
youshe@983: 
youshe@983:     <para id="x_3f">C'est déjà pratique de savoir que nous avons modifié le
youshe@983:       fichier <filename>hello.c</filename>, mais nous préférerions savoir
youshe@983:       exactement <emphasis>ce que</emphasis> nous avons changé. Pour ceci, nous
youshe@983:       utilisons la commande <command role="hg-cmd">hg diff</command>.</para>
youshe@983: 
youshe@983:     &interaction.tour.diff;
youshe@983: 
youshe@983:     <tip>
youshe@983:       <title>Comprendre les patches</title>
youshe@983:    
youshe@983:       <para id="x_683">Penser à jeter un oeil à <xref
youshe@983:           linkend="sec:mq:patch"/> si vous n'arrivez pas à lire la sortie
youshe@983:         ci-dessus.</para>
youshe@983:     </tip>
youshe@983:   </sect1>
youshe@983:   <sect1>
andre@1015:     <title>Enregistrer vos modifications dans une nouvelle révision</title>
youshe@983:    
youshe@983:     <para id="x_40">Nous pouvons modifier des fichiers, compiler et tester
youshe@983:       nos modifications, et utiliser les commandes <command role="hg-cmd">hg
youshe@983:         status</command> et <command role="hg-cmd">hg diff</command> pour
youshe@983:       voir les modifications effectuées, jusqu'à ce que nous soyons assez
youshe@983:       satisfaits pour décider d'enregistrer notre travail dans un
wilk@1005:       <quote>changeset</quote>.</para>
youshe@983: 
youshe@983:     <para id="x_41">La commande <command role="hg-cmd">hg commit</command>
youshe@983:       vous laisse créer une nouvelle révision, nous désignerons généralement
youshe@983:       cette opération par <quote>faire un commit</quote> ou
andre@1015:       <quote>commiter</quote>.</para>
youshe@983: 
youshe@983:     <sect2>
youshe@983:     <title>Définir le nom d'utilisateur</title>
youshe@983: 
youshe@983:       <para id="x_42">Quand vous exécutez la commande <command
youshe@983:           role="hg-cmd">hg commit</command> pour la première fois, il n'est
youshe@983:         pas garanti qu'elle réussisse du premier coup. En effet, Mercurial
youshe@983:         enregistre votre nom et votre adresse avec chaque modification que
youshe@983:         vous effectuez, de manière à ce que vous soyez capable (ou d'autres
wilk@1005:         le soient) de savoir qui a fait telle modification. Mercurial essaye
youshe@983:         automatiquement de découvrir un nom d'utilisateur qui ait un minimum
wilk@1005:         de sens pour effectuer l'opération de <quote>commit</quote> avec. Il va essayer
youshe@983:         chacune des méthodes suivantes, dans l'ordre :</para>
youshe@983: 
youshe@983:       <orderedlist>
youshe@983:         <listitem><para id="x_43">Si vous spécifiez l'option <option
youshe@983:               role="hg-opt-commit">-u</option> avec la commande <command
youshe@983:               role="hg-cmd">hg commit</command>, suivi d'un nom
youshe@983:             d'utilisateur, ceci aura toujours la priorité sur les autres
youshe@983:             méthodes ci dessous.</para></listitem>
youshe@983:         <listitem><para id="x_44">Si vous avez défini une variable
youshe@983:             d'environnement <envar>HGUSER</envar>, c'est cette valeur qui est
youshe@983:             alors utilisée.</para></listitem>
youshe@983:         <listitem><para id="x_45">Si vous créez un fichier nommé <filename
youshe@983:               role="special">.hgrc</filename> dans votre répertoire
youshe@983:             \textit{home}, avec une entrée <envar
youshe@983:               role="rc-item-ui">username</envar>, c'est la valeur associée
youshe@983:             qui sera utilisée. Pour voir à quoi ressemble le contenu de ce
youshe@983:             fichier regardez la section <xref
youshe@983:               linkend="sec:tour-basic:username"/>
youshe@983:             ci-dessous.</para></listitem>
youshe@983:         <listitem><para id="x_46">Si vous avez défini une variable
youshe@983:             d'environnement <envar>EMAIL</envar> celle ci sera utilisée
youshe@983:             ensuite.</para></listitem>
youshe@983:         <listitem><para id="x_47">Enfin, Mercurial interrogera votre système
youshe@983:             pour trouver votre nom d'utilisateur local ainsi que le nom de la
youshe@983:             machine hôte, et il fabriquera un nom d'utilisateur à partir de
wilk@1005:             ces données. Comme il arrive souvent que ce genre de nom soit
youshe@983:             totalement inutile, il vous préviendra en affichant un message
youshe@983:             d'avertissement.</para></listitem>
youshe@983:       </orderedlist>
youshe@983:    
youshe@983:       <para id="x_48">Si tous ces mécanismes échouent, Mercurial n'exécutera
youshe@983:         pas la commande, affichant un message d'erreur. Dans ce cas, il ne
wilk@1005:         vous laissera pas effectuer de <quote>commit</quote> tant que vous n'aurez pas
youshe@983:         défini un nom d'utilisateur.</para>
youshe@983:    
youshe@983:       <para id="x_49">Vous devriez penser à utiliser la variable
youshe@983:         d'environement <envar>HGUSER</envar> et l'option <option
youshe@983:           role="hg-opt-commit">-u</option> comme moyen pour
youshe@983:         <emphasis>changer</emphasis> le nom d'utilisateur par défaut. Pour
youshe@983:         une utilisation normale, la manière la plus simple et robuste
youshe@983:         d'opérer est de créer un fichier <filename
wilk@1005:           role="special">.hgrc</filename>, voir ci-dessous pour les détails
youshe@983:         à ce sujet.</para>
youshe@983: 
youshe@983:       <sect3 id="sec:tour-basic:username">
youshe@983:         <title>Créer un fichier de configuration pour Mercurial</title>
youshe@983: 
youshe@983:         <para id="x_4a">Pour définir un nom d'utilisateur, utilisez votre 
youshe@983:           éditeur de texte favori pour créer un fichier <filename 
youshe@983:             role="special">.hgrc</filename> dans votre répertoire home. 
youshe@983:           Mercurial va utiliser ce fichier pour retrouver votre 
youshe@983:           configuration personnelle. Le contenu initial devrait
youshe@983:           ressembler à ceci :</para>
youshe@983:    
youshe@983:         <tip>
youshe@983:           <title><quote>Home directory</quote> sous Windows</title>
youshe@983:    
wilk@1005:           <para id="x_716">Quand on parle de répertoire <quote>home</quote>, sur une version
youshe@983:             anglaise d'une installation de Windows, il s'agira habituellement
youshe@983:             d'un répertoire nommée comme votre nom dans <filename>C:\Documents 
andre@1015:               and Settings</filename>. Vous pouvez trouver de quel répertoire
youshe@983:             il s'agit en lançant une fenêtre d'interpréteur de commande et en
youshe@983:             exécutant la commande suivante :</para>
belaran@973:           
youshe@983:           <screen><prompt>C:\</prompt> <userinput>echo
youshe@983:               %UserProfile</userinput></screen>
youshe@983:         </tip>
youshe@983:    
youshe@983:         <programlisting># This is a Mercurial configuration file.
belaran@973: [ui]
belaran@973: username = Firstname Lastname &lt;email.address@domain.net&gt;</programlisting>
belaran@973: 
youshe@983:         <para id="x_4b">La ligne avec <literal>[ui]</literal> commence une
youshe@983:           <emphasis>section</emphasis> du fichier de configuration, ainsi la ligne
youshe@983:           <quote><literal>username = ...</literal></quote> signifie <quote>
youshe@983:             définir la valeur de l'élément <literal>username</literal> dans la
youshe@983:             section <literal>ui</literal></quote>. Une section continue jusqu'à ce
youshe@983:           qu'une nouvelle commence, ou que la fin du fichier soit atteinte.
youshe@983:           Mercurial ignore les lignes vides et traite tout texte situé à la suite
youshe@983:           d'un <quote><literal>#</literal></quote> jusqu'à la fin de la ligne
youshe@983:           comme un commentaire.</para>
belaran@973: 
belaran@973:       </sect3>
belaran@973:       <sect3>
belaran@973:         <title>Choisir un nom d'utilisateur</title>
youshe@983:  
youshe@983:         <para id="x_4c">Vous pouvez utiliser n'importe quelle valeur 
youshe@983:           pour votre <literal>username</literal>, car cette information 
youshe@983:           est destinée à d'autres personnes et non à être interprétée 
youshe@983:           par Mercurial. La convention que la plupart des personnes
wilk@1005:           suivent est d'utiliser leur nom suivie de leur adresse email,
youshe@983:           comme montré ci-dessus :</para>
youshe@983:         <note>
youshe@983:           <para id="x_4d">Le mécanisme interne du serveur web intégré à Mercurial,
youshe@983:             masque les adresses emails, pour rendre plus difficile leurs
youshe@983:             récupérations par les outils utilisés par les spammmers.
youshe@983:             Ceci réduit la probabilité que de recevoir encore plus de
youshe@983:             spam si vous vous publiez un dépôt sur internet.</para>
youshe@983:         </note>
youshe@983:       </sect3>
youshe@983:     </sect2>
youshe@983:     <sect2>
wilk@1005:         <title>Rédiger un message de <quote>commit</quote></title>
wilk@1005:   
wilk@1005:         <para id="x_4e">Lorsqu'on effectue une opération de <quote>commit</quote>, Mercurial
youshe@983:         lance automatiquement un éditeur de texte pour permettre de saisir
youshe@983:         un message qui décrira les modifications effectuées dans cette
youshe@983:         révision. Ce message est nommé le <emphasis>message de commit</emphasis>. 
youshe@983:         Ce sera un enregistrement pour tout lecteur expliquant le pourquoi 
youshe@983:         et le comment de vos modifications, et il sera affiché par la 
youshe@983:         commande <command role="hg-cmd">hg log</command>.</para>
youshe@983:  
youshe@983:       &interaction.tour.commit; 
youshe@983:   
youshe@983:       <para id="x_4f">L'éditeur que la commande <command role="hg-cmd">hg 
youshe@983:           commit</command> déclenche ne contiendra qu'une ligne vide suivi 
youshe@983:         d'un certain nombre de lignes commençant par <quote><literal>HG:
youshe@983:         </literal></quote>.</para>
youshe@983:     
youshe@983:         <programlisting>
belaran@973:     This is where I type my commit comment.
belaran@973:     
belaran@973:     HG: Enter commit message.  Lines beginning with 'HG:' are removed.
belaran@973:     HG: --
belaran@973:     HG: user: Bryan O'Sullivan &lt;bos@serpentine.com&gt;
belaran@973:     HG: branch 'default'
belaran@973:     HG: changed hello.c</programlisting>
belaran@973: 
belaran@973: 
youshe@983:       <para id="x_50">Mercurial ignore les lignes qui commencent 
youshe@983:         avec <quote><literal>HG:</literal></quote>, il ne les 
youshe@983:         utilise que pour nous indiquer quels fichiers modifiés il se
wilk@1005:         prépare à <quote>commiter</quote>. Modifier ou effacer ces lignes n'a
wilk@1005:         aucune conséquence sur l'opération de <quote>commit</quote>.
youshe@983:       </para>
youshe@983: 
youshe@983:     </sect2>
youshe@983:     <sect2>
wilk@1005:         <title>Rédiger un message approprié</title>
youshe@983:   
youshe@983:       <para id="x_51">Comme <command role="hg-cmd">hg log</command> n'affiche
wilk@1005:           que la première ligne du message de <quote>commit</quote> par défaut, il est souvent
wilk@1005:           considéré comme une bonne pratique de rédiger des messages de <quote>commit</quote>
youshe@983:         qui tiennent sur une seule ligne. Voilà un exemple concret de message 
wilk@1005:         de <quote>commit</quote> qui <emphasis>ne suit pas</emphasis> cette directive, et
youshe@983:         qui a donc un résumé peu lisible.</para>
youshe@983: 
youshe@983:       <programlisting>
belaran@973: changeset:   73:584af0e231be
belaran@973: user:        Censored Person &lt;censored.person@example.org&gt;
belaran@973: date:        Tue Sep 26 21:37:07 2006 -0700
belaran@973: summary:     include buildmeister/commondefs.   Add an exports and install
youshe@983:       </programlisting>
youshe@983:   
andre@1015:       <para id="x_52">À ce sujet, il faut noter qu'il n'existe pas de règle 
youshe@983:         absolue dans ce domaine. Mercurial lui-même n'interprète pas les 
wilk@1005:         contenus des messages de <quote>commit</quote>, ainsi votre projet est libre de 
youshe@983:         concevoir différentes politiques de mise en page des messages.</para>
youshe@983:       
youshe@983:       <para id="x_53">Ma préférence personnelle va au message court, mais 
youshe@983:         informatif, qui offre des précisions supplémentaires par rapport à ce 
youshe@983:         que pourrait m'apprendre une commande <command role="hg-cmd">hg log 
youshe@983:           --patch</command>.</para>
youshe@983:       
youshe@983:       <para id="x_55">Si vous exécutez la commande <command role="hg-cmd">hg
youshe@983:           commit</command> sans aucun argument, elle enregistre tous les 
youshe@983:         changements qui ont été fait, et qui sont indiqué par les commandes
youshe@983:         <command role="hg-cmd">hg status</command> et  <command 
youshe@983:           role="hg-cmd">hg diff</command>.</para>
youshe@983:       
youshe@983:       <note>
youshe@983:         <title>Une surprise pour les utilisateurs habitués à Subversion</title>
youshe@983:    
youshe@983:         <para id="x_717">Comme n'importe quel autre commande de Mercurial, si
wilk@1005:           vous ne soumettez pas de manière explicite les noms des fichiers à
andre@1015:           <quote>commiter</quote> à la commande <command role="hg-cmd">hg commit</command>, elle
youshe@983:           va travailler sur l'ensemble du répertoire de travail. Soyez conscient
youshe@983:           de ceci si vous venez du monde Subversion ou CVS, car vous pourriez
andre@1015:           vous attendre à ce qu'elle opère uniquement sur le répertoire courant et ses
andre@1015:           sous-répertoires.</para>
youshe@983:       </note>
youshe@983:     </sect2>
youshe@983:     <sect2>
wilk@1005:         <title>Annuler un <quote>commit</quote></title>
belaran@973: 
belaran@973:       <para id="x_54">Si, en rédigeant le message, vous décidez que 
wilk@1005:           finalement vous ne voulez pas effectuer ce <quote>commit</quote>, il suffit 
wilk@1005:         de quitter simplement l'éditeur sans sauvegarder. Ceci n'aura aucune 
belaran@973:         conséquence sur le dépôt ou les fichiers du répertoire de 
belaran@973:         travail.</para>
youshe@983:     </sect2>
youshe@983:   
youshe@983:     <sect2>
youshe@983:       <title>Admirer votre travail</title>
youshe@983:   
wilk@1005:       <para id="x_56">Une fois que votre <quote>commit</quote> est terminé, vous
youshe@983:         pouvez utiliser la commande <command role="hg-cmd">hg tip</command>
wilk@1005:         pour afficher le <quote>changeset</quote> que vous venez de créer. Cette
wilk@1005:         commande produit une sortie à l'écran qui est identique à celle du
youshe@983:         <command role="hg-cmd">hg log</command>, mais qui n'affiche que la
youshe@983:         dernière révision du dépôt.</para>
youshe@983:  
youshe@983:       &interaction.tour.tip; 
youshe@983:   
youshe@983:       <para id="x_57">On fait couramment référence à la dernière révision 
youshe@983:         du dépôt comme étant la <emphasis>révision tip</emphasis>, ou plus
youshe@983:         simplement le <emphasis>tip</emphasis>.</para>
youshe@983:   
youshe@983:       <para id="x_684">Au passage, la commande <command role="hg-cmd">hg
youshe@983:           tip</command> accepte la plupart des options qu'accepte 
youshe@983:         <command role="hg-cmd">hg log</command>. Ainsi <option
andre@1015:           role="hg-opt-global">-v</option> ci-dessus implique <quote>soit
andre@1021:           verbeux</quote>, <option role="hg-opt-tip">-p</option>
andre@1021:         veut dire <quote>affiche le patch</quote>. L'utilisation de l'option
belaran@973:         <option role="hg-opt-tip">-p</option> pour afficher un patch est un
belaran@973:         autre exemple de la cohérence des commandes évoquée plus tôt.</para>
belaran@973: 
belaran@973:     </sect2>
belaran@973:   </sect1>
belaran@973:   <sect1>
belaran@973:     <title>Partager ses modifications</title>
belaran@973: 
belaran@997:     <para id="x_58">Nous avons mentionné plus haut que les dépôts 
youshe@983:       de Mercurial sont autosuffisants. Ce qui signifie que la nouvelle
youshe@983:       révision que vous venez de créer existe seulement dans votre 
youshe@983:       répertoire <filename class="directory">my-hello</filename>. Étudions 
youshe@983:       comment propager cette modification dans d'autres dépôts.</para>
belaran@973: 
belaran@973:     <sect2 id="sec:tour:pull">
belaran@973:       <title>Récupérer les modifications d'autres dépôts</title>
belaran@973: 
belaran@997:       <para id="x_59">Pour commencer, construisons un clone de notre dépôt 
youshe@983:         <filename class="directory">hello</filename> qui ne contiendra pas 
youshe@983:         le changement que nous venons d'effectuer. Nous l'appellerons notre 
youshe@983:         dépôt temporaire <filename
youshe@983:           class="directory">hello-pull</filename>.</para>
youshe@983:  
youshe@983:       &interaction.tour.clone-pull;
youshe@983:  
youshe@983:       <para id="x_5a">Nous allons utiliser la commande <command
youshe@983:           role="hg-cmd">hg pull</command> pour envoyer les modifications
youshe@983:         depuis <filename class="directory">my-hello</filename> dans <filename
youshe@983:           class="directory">hello-pull</filename>. Néanmoins, récupérer
youshe@983:         aveuglement des modifications depuis un dépôt a quelque chose d'un
youshe@983:         peu effrayant. Mercurial propose donc une commande <command
youshe@983:           role="hg-cmd">hg incoming</command> qui permet de savoir quelles
youshe@983:         modifications la commande <command role="hg-cmd">hg pull</command>
youshe@983:         <emphasis>pourrait</emphasis> entraîner dans notre dépôt, et ceci
youshe@983:         sans effectuer réellement de modification dessus.</para>
belaran@973: 
belaran@973:       &interaction.tour.incoming; 
youshe@983:   
youshe@983:       <para id="x_5c">Apporter les modifications rapatriées dans un dépôt se
youshe@983:         résume donc à exécuter la commande <command role="hg-cmd">hg
youshe@983:           pull</command>, et préciser depuis quel dépôt effectuer le <command
youshe@983:           role="hg-cmd">hg pull</command>.</para>
youshe@983:       
youshe@983:       &interaction.tour.pull;
youshe@983:   
youshe@983:       <para id="x_5d">Comme vous le voyez avec une sortie avant et après de la
youshe@983:         commande <command role="hg-cmd">hg tip</command>, nous avons réussi à
youshe@983:         récupérer aisément les modifications dans notre dépôt. Il reste néanmoins
wilk@1005:         quelque chose à faire avant de retrouver ces modifications dans l'espace de
youshe@983:         travail.</para>
youshe@983:    
youshe@983:       <tip>
youshe@983:         <title>Récupérer des changements précis</title>
youshe@983:    
youshe@983:         <para id="x_5b">Il est possible à cause du délai entre l'exécution de la
youshe@983:           commande <command role="hg-cmd">hg incoming</command> et l'exécution de
youshe@983:           la commande <command role="hg-cmd">hg pull</command>, que vous ne
youshe@983:           puissiez pas voir toutes les modifications que vous rapporterez d'un
youshe@983:           autre dépôt. Supposons que vous récupériez les modifications d'un dépôt
youshe@983:           situé quelque part sur le réseau. Alors que vous regardez le résultat de
youshe@983:           la commande <command role="hg-cmd">hg incoming</command>, et avant que
youshe@983:           vous ne décidiez de récupérer ces modifications, quelqu'un peut ajouter
youshe@983:           de nouvelles révisions dans le dépôt distant. Ce qui signifie que vous
wilk@1005:           récupérez plus de révisions que ce que vous aviez regardées en utilisant
youshe@983:           la commande <command role="hg-cmd">hg incoming</command>.</para>
youshe@983: 
youshe@983:         <para id="x_718">Si vous voulez seulement récupérer ce que vous aviez
wilk@1005:           vérifié à l'aide de la commande <command role="hg-cmd">hg
wilk@1005:             incoming</command>, ou que pour d'autres raisons vous ne souhaitiez
youshe@983:           récupérer qu'un sous ensemble des révisions supplémentaires
wilk@1005:           disponibles, indiquez simplement les modifications que vous souhaitez
youshe@983:           récupérer par leurs ID de révision, soit <command>hg pull
youshe@983:             -r7e95bb</command>. </para>
youshe@983:       </tip>
youshe@983:   
youshe@983:     </sect2>
youshe@983:     <sect2>
youshe@983:       <title>Mise à jour de l'espace de travail</title>
youshe@983:   
youshe@983:       <para id="x_5e">Nous avons jusqu'à maintenant grossièrement défini la
youshe@983:         relation entre un dépôt et un espace de travail. La commande <command
youshe@983:           role="hg-cmd">hg pull</command> que nous avons exécutée dans la section 
youshe@983:         <xref linkend="sec:tour:pull"/> a apporté des modifications, que nous
youshe@983:         avons vérifiées, dans notre dépôt, mais il n'y a aucune trace de ces
youshe@983:         modifications dans notre espace de travail. En effet, <command
youshe@983:           role="hg-cmd">hg pull</command> ne touche pas (par défaut) à l'espace
youshe@983:         de travail. C'est la commande <command role="hg-cmd">hg update</command>
youshe@983:         qui s'en charge.</para>
youshe@983:  
youshe@983:       &interaction.tour.update;
youshe@983:   
youshe@983:       <para id="x_5f">Il peut sembler un peu étrange que la commande <command
youshe@983:           role="hg-cmd">hg pull</command> ne mette pas à jour l'espace de travail
youshe@983:         automatiquement. Il y a en fait une très bonne raison à cela : vous
wilk@1005:         pouvez utiliser la commande <command role="hg-cmd">hg update</command>
youshe@983:         pour mettre à jour votre espace de travail à l'état dans lequel il était 
youshe@983:         à <emphasis>n'importe quelle révision</emphasis> de l'historique du dépôt. 
youshe@983:         Si vous aviez un espace de travail contenant une ancienne
youshe@983:         révision&emdash;pour chercher l'origine d'un bug, par exemple&emdash;et
youshe@983:         que vous effectuiez un <command role="hg-cmd">hg pull</command> qui
youshe@983:         mettrait à jour automatiquement votre espace de travail, vous ne seriez
youshe@983:         probablement pas très satisfait.</para>
youshe@983:   
youshe@983:       <para id="x_60">Néanmoins, comme les opérations de pull sont très souvent
youshe@983:         suivies d'un update, Mercurial vous permet de combiner les
youshe@983:         deux aisément en passant l'option <option role="hg-opt-pull">-u</option> 
youshe@983:         à la commande <command role="hg-cmd">hg pull</command>.</para>
youshe@983:   
youshe@983:       <para id="x_61">Si vous étudiez de nouveau la sortie de la commande <command
youshe@983:           role="hg-cmd">hg pull</command> dans la section <xref
youshe@983:           linkend="sec:tour:pull"/> quand nous l'avons exécutée sans l'option
youshe@983:         <option role="hg-opt-pull">-u</option>, vous pouvez constater qu'elle a
youshe@983:         affiché un rappel assez utile : vous devez encore effectuer une
youshe@983:         opération pour mettre à jour votre espace de travail.</para>
youshe@983: 
youshe@983:       <para id="x_62">Pour découvrir sur quelle révision de l'espace de 
youshe@983:         travail on se trouve, utilisez la commande <command role="hg-cmd">hg
youshe@983:           parents</command>.</para>
youshe@983:  
youshe@983:       &interaction.tour.parents;
youshe@983:    
youshe@983:       <para id="x_63">Si vous regardez de nouveau le dessin <xref
youshe@983:           linkend="fig:tour-basic:history"/>, vous verrez les flèches reliant
youshe@983:         entre elles les révisions. Le nœud d'où la flèche
youshe@983:         <emphasis>part</emphasis> est dans chaque cas un parent,
youshe@983:         et le nœud où la flèche <emphasis>arrive</emphasis> est un
youshe@983:         enfant.</para>
youshe@983: 
youshe@983:       <para id="x_64">Pour mettre à jour l'espace de travail d'une révision
wilk@1005:           particulière, indiquez un numéro de révision ou un <quote>changeset
andre@1020:               ID</quote> à la commande <command role="hg-cmd">hg update</command>.</para>
youshe@983:   
youshe@983:       &interaction.tour.older;
youshe@983:    
youshe@983:       <para id="x_65">Si vous ne précisez pas de manière explicite de numéro 
youshe@983:         de révision la commande <command role="hg-cmd">hg update</command>
youshe@983:         mettra à jour votre espace de travail avec le contenu de la révison
andre@1015:         <quote>tip</quote>, comme montré dans l'exemple ci-dessus lors du second
youshe@983:         appel à <command role="hg-cmd">hg update</command>.</para>
youshe@983:     
youshe@983:     </sect2>
youshe@983:     <sect2>
youshe@983:       <title>Transférer les modifications vers un autre dépôt</title>
youshe@983:   
youshe@983:       <para id="x_66">Mercurial vous laisse transférer les modifications vers
youshe@983:         un autre dépôt, depuis votre dépôt actuel. Comme dans l'exemple du
youshe@983:         <command role="hg-cmd">hg pull</command> ci-dessus, nous allons créer
youshe@983:         un dépôt temporaire vers lequel transférer nos modifications.</para>
youshe@983:         
youshe@983:       &interaction.tour.clone-push;
youshe@983:   
youshe@983:       <para id="x_67">La commande <command role="hg-cmd">hg outgoing</command>
youshe@983:         nous indique quels changements nous allons transférer vers l'autre
youshe@983:         serveur.</para>
youshe@983:  
youshe@983:       &interaction.tour.outgoing;
youshe@983:   
youshe@983:       <para id="x_68">Et la commande <command role="hg-cmd">hg push</command> 
youshe@983:         effectue réellement le transfert.</para>
youshe@983:  
youshe@983:       &interaction.tour.push;
youshe@983:   
youshe@983:       <para id="x_69">Comme avec <command role="hg-cmd">hg pull</command>, la
youshe@983:         commande <command role="hg-cmd">hg push</command> ne met pas à jour
youshe@983:         le répertoire de travail du dépôt dans lequel il transfère les
youshe@983:         modifications. À l'inverse de <command role="hg-cmd">hg
youshe@983:           pull</command>, <command role="hg-cmd">hg push</command> ne fournit
youshe@983:         pas d'option <literal>-u</literal> pour forcer la mise à jour de
youshe@983:         l'espace de travail cible. Cette asymétrie est délibéré : le dépot
youshe@983:         vers lequel nous transférons peut très bien être un serveur distant
youshe@983:         et partagé par plusieurs personnes. Si nous devions mettre à jour son
youshe@983:         répertoire de travail alors que quelqu'un d'autre travaille dessus,
youshe@983:         nous risquerions de perturber son travail.</para>
youshe@983:   
andre@1015:       <para id="x_6a">Que se passe-t-il lorsque vous essayez de récupérer
youshe@983:         ou de transférer vos modifications et que le dépôt cible a déjà reçu
youshe@983:         ces modifications ? Rien de bien excitant.</para>
youshe@983:  
youshe@983:       &interaction.tour.push.nothing;
youshe@983:   
youshe@983:     </sect2>
youshe@983:   
youshe@983:     <sect2>
youshe@983:       <title>Emplacements par défaut</title>
youshe@983: 
youshe@983:       <para id="x_719">Quand nous faisons un clone d'un dépôt, Mercurial
youshe@983:         enregistre l'emplacement du dépôt d'origine dans le fichier
youshe@983:         <filename>.hg/hgrc</filename> de notre nouveau dépôt. Si nous ne
youshe@983:         fournissons pas d'emplacement à la commande <command>hg
youshe@983:           pull</command> ou à la commande <command>hg push</command>, ces
youshe@983:         commandes utiliseront alors cet emplacement comme valeur par défaut.
youshe@983:         Les commandes <command>hg incoming</command> et <command>hg
youshe@983:           outgoing</command> feront de même.</para>
youshe@983:   
youshe@983:       <para id="x_71a">Si vous regardez le fichier
youshe@983:         <filename>.hg/hgrc</filename>, vous constaterez que son contenu
youshe@983:         ressemble à ce qui suit.</para>
youshe@983:   
youshe@983:       <programlisting>[paths]
belaran@973: default = http://www.selenic.com/repo/hg</programlisting>
belaran@973:       
youshe@983:       <para id="x_71b">Il est possible&emdash;et souvent
youshe@983:         pratique&emdash;d'avoir un emplacement par défaut pour les commandes
youshe@983:         <command>hg push</command> et <command>hg outgoing</command>
youshe@983:         différent de celui des commandes <command>hg pull</command> et
youshe@983:         <command>hg incoming</command>. C'est faisable en ajoutant une entrée
youshe@983:         <literal>default-push</literal> à la section
youshe@983:         <literal>[paths]</literal> du <filename>.hg/hgrc</filename>, comme
youshe@983:         suit.</para>
youshe@983:    
youshe@983:       <programlisting>[paths]
belaran@973: default = http://www.selenic.com/repo/hg
belaran@973: default-push = http://hg.example.com/hg</programlisting>
youshe@983: 
youshe@983:     </sect2>
youshe@983:     <sect2>
youshe@983:       <title>Partager ses modifications à travers le réseau</title>
youshe@983:   
youshe@983:       <para id="x_6b">Les commandes que nous avons étudiées dans les sections
youshe@983:         précédentes ne sont pas limitées aux dépôts locaux. Chacune fonctionne 
youshe@983:         de la même manière à travers une connexion réseau, il suffit de lui 
youshe@983:         passer une URL à la place d'un chemin de fichier local.</para>
youshe@983:  
youshe@983:       &interaction.tour.outgoing.net;
youshe@983:   
youshe@983:       <para id="x_6c">Dans cet exemple, nous allons voir quels changements 
wilk@1005:         nous pourrions transférer vers le dépôt distant, mais le dépôt n'est, 
youshe@983:         de manière tout à fait compréhensible, pas configuré pour accepter 
youshe@983:         des modifications d'utilisateurs anonymes.</para>
youshe@983:  
youshe@983:       &interaction.tour.push.net; 
youshe@983:     
youshe@983:     </sect2>
youshe@983: 
belaran@973:   </sect1>
belaran@973: 
belaran@973:   <sect1>
youshe@983:     <title>Commencer un nouveau projet</title>
youshe@983: 
youshe@983:     <para id="x_71c">Il est tout aussi aisé de commencer un nouveau projet
youshe@983:       que de travailler sur un qui existe déjà. La commande <command>hg
youshe@983:         init</command> crée un nouveau dépôt Mercurial vide.</para>
youshe@983: 
youshe@983:     &interaction.ch01-new.init;
youshe@983: 
youshe@983:     <para id="x_71d">Ceci crée simplement un répertoire nommé
youshe@983:       <filename>myproject</filename> dans le répertoire courant.</para>
youshe@983: 
youshe@983:     &interaction.ch01-new.ls;
youshe@983: 
youshe@983:     <para id="x_71e">Nous pouvons dire que <filename>myproject</filename> est
youshe@983:       un dépôt Mercurial car il contient un répertoire
youshe@983:       <filename>.hg</filename>.</para>
youshe@983: 
youshe@983:     &interaction.ch01-new.ls2;
youshe@983: 
youshe@983:     <para id="x_71f">Si vous voulons ajouter quelques fichiers préexistants
youshe@983:       dans ce dépôt, il suffit de les recopier dans le répertoire de travail,
youshe@983:       et demander à Mercurial de commencer à les suivre en utilisant la
youshe@983:       commande <command>hg add</command>.</para>
youshe@983: 
youshe@983:     &interaction.ch01-new.add;
youshe@983: 
youshe@983:     <para id="x_720">Une fois que nous sommes satisfaits de notre projet,
youshe@983:       nous pouvons commencer à ajouter nos révisions.</para>
youshe@983: 
youshe@983:     &interaction.ch01-new.commit;
youshe@983: 
youshe@983:     <para id="x_721">Il ne prend que quelques instants pour commencer à
belaran@973:       utiliser Mercurial sur un nouveau projet, ce qui fait aussi de ses
belaran@973:       points forts. Travailler avec une gestion de révision devient très
belaran@973:       facile, nous pouvons même l'utiliser pour les plus petits projets où
wilk@1005:       nous aurions probablement jamais pensé utiliser un outil aussi
belaran@973:       complexe.</para>
youshe@983:   </sect1>
belaran@964: </chapter>
belaran@964: 
belaran@964: <!--
belaran@964: local variables: 
belaran@964: sgml-parent-document: ("00book.xml" "book" "chapter")
belaran@964: end:
belaran@973: -->