hgbook
diff fr/tour-basic.tex @ 959:b3cb66d935cf
Finished tour-merge.tex
author | Romain PELISSE <belaran@gmail.com> |
---|---|
date | Mon Feb 23 23:53:18 2009 +0100 (2009-02-23) |
parents | 61f7bf2e562d 5abf0e11ce7e |
children | e3913a4b5b26 |
line diff
1.1 --- a/fr/tour-basic.tex Sun Feb 22 16:15:40 2009 +0100 1.2 +++ b/fr/tour-basic.tex Mon Feb 23 23:53:18 2009 +0100 1.3 @@ -467,14 +467,19 @@ 1.4 Vous pouvez utiliser n'importe quelle valeur pour votre \texttt{username}, 1.5 car cette information est destinée à d'autres personnes et non à être 1.6 interprétée par Mercurial. La convention que la plupart des personnes 1.7 +<<<<<<< local 1.8 suivent est d'utiliser leurs noms suivies de leurs adresses emails, 1.9 comme montrée ci-dessus: 1.10 +======= 1.11 +suivent est d'utiliser leur nom suivi de leur adresse email, 1.12 +comme montrée ci dessus: 1.13 +>>>>>>> other 1.14 1.15 \begin{note} 1.16 Le mécanisme interne du serveur \textit{web} intégré à Mercurial, 1.17 masque les adresses emails, pour rendre plus difficile leurs 1.18 récupérations par les outils utilisés par les \textit{spammmers}. 1.19 - Ceci réduit la probabilité que vous receviez encore plus de 1.20 + Ceci réduit la probabilité que de recevoir encore plus de 1.21 \textit{spam} si vous vous publiez un dépôt sur internet. 1.22 \end{note} 1.23 1.24 @@ -483,7 +488,7 @@ 1.25 Lorsqu'on effectue une opération de \textit{commit}, Mercurial 1.26 lance automatiquement un éditeur de texte pour permettre de saisir 1.27 un message qui décrira les modifications effectuées dans ce 1.28 -\textit{changeset}. Ce message est nommée le \emph{message de 1.29 +\textit{changeset}. Ce message est nommé le \emph{message de 1.30 \textit{commit}}. Ce sera un enregistrement pour tout lecteur 1.31 expliquant le pourquoi et le comment de vos modifications, et il sera 1.32 affiché par la commande \hgcmd{log}. 1.33 @@ -496,7 +501,7 @@ 1.34 \emph{empty line} 1.35 HG: changed hello.c 1.36 \end{codesample2} 1.37 -Mercurial ignore les lignes qui commence avec ``\texttt{HG:}'', il 1.38 +Mercurial ignore les lignes qui commencent avec ``\texttt{HG:}'', il 1.39 ne les utilise que pour nous indiquer quels fichiers modifiés il se 1.40 prépare à \textit{commiter}. Modifier ou effacer ces lignes n'a 1.41 aucune conséquence sur l'opération de \textit{commit}. 1.42 @@ -505,7 +510,11 @@ 1.43 1.44 Comme \hgcmd{log} n'affiche que la première ligne du message de 1.45 \textit{commit} par défaut, il est souvent considéré comme une bonne 1.46 +<<<<<<< local 1.47 pratique de rédiger des messages de \textit{commit} qui tiennent 1.48 +======= 1.49 +pratique de rédiger des messages de \textit{commit} qui n'entrent que 1.50 +>>>>>>> other 1.51 sur une seule ligne. Voilà un exemple concret de message de 1.52 \textit{commit} qui \emph{ne suit pas} cette directive, et qui a donc 1.53 un résumé peu lisible. 1.54 @@ -519,22 +528,35 @@ 1.55 A ce sujet, il faut noter qu'il n'existe pas de règle absolue dans ce 1.56 domaine. Mercurial lui-même n'interprète pas les contenus des messages 1.57 de \textit{commit}, ainsi votre projet est libre de concevoir différentes 1.58 +<<<<<<< local 1.59 politiques de mise en page des messages. 1.60 +======= 1.61 +politiques de formatage des messages. 1.62 +>>>>>>> other 1.63 1.64 Ma préférence personnelle va au message court, mais informatif, qui offre 1.65 -des précisions supplémentaires à ce que pourrait m'apprendre une commande 1.66 +des précisions supplémentaires par rapport à ce que pourrait m'apprendre une commande 1.67 \hgcmdargs{log}{--patch}. 1.68 1.69 \subsection{Annuler un \textit{commit}} 1.70 1.71 Si, en rédigeant le message, vous décidez que finalement vous ne 1.72 +<<<<<<< local 1.73 voulez pas effectuer ce \textit{commit}, il suffit de simplement quitter 1.74 l'éditeur sans sauvegarder. Ceci n'aura aucune conséquence sur le dépôt ou 1.75 +======= 1.76 +voulez pas effectuer ce \textit{commit}, il suffit de quitter simplement 1.77 +l'éditeur sans sauver. Ceci n'aura aucune conséquence sur le dépôt ou 1.78 +>>>>>>> other 1.79 les fichiers de l'espace de travail. 1.80 1.81 +<<<<<<< local 1.82 Si vous exécuter la commande \hgcmd{commit} sans aucun argument, elle 1.83 +======= 1.84 +Si vous exécutez la commande \hgcmd{commit} sans aucun argument, elle 1.85 +>>>>>>> other 1.86 enregistre toutes les modifications que vous avez faites, comme le montre 1.87 -la commande \hgcmd{status} et \hgcmd{diff}. 1.88 +les commandes \hgcmd{status} et \hgcmd{diff}. 1.89 1.90 \subsection{Admirer votre travail} 1.91 1.92 @@ -544,7 +566,11 @@ 1.93 identique à celle du \hgcmd{log}, mais qui n'affiche que la dernière 1.94 révision du dépôt. 1.95 \interaction{tour.tip} 1.96 +<<<<<<< local 1.97 On fait couramment référence à la dernière révision du dépôt comme 1.98 +======= 1.99 +On fait couramment référénce à la dernière révision du dépôt comme 1.100 +>>>>>>> other 1.101 étant la révision \textit{tip}, ou plus simplement le \textit{tip}. 1.102 1.103 \section{Partager ses modifications} 1.104 @@ -560,7 +586,11 @@ 1.105 1.106 Pour commencer, construisons un clone de notre dépôt \dirname{hello} 1.107 qui ne contiendra pas le changement que nous venons d'effectuer. Nous 1.108 +<<<<<<< local 1.109 l'appellerons notre dépôt temporaire \dirname{hello-pull}. 1.110 +======= 1.111 +appelerons notre dépôt temporaire \dirname{hello-pull}. 1.112 +>>>>>>> other 1.113 \interaction{tour.clone-pull} 1.114 1.115 Nous allons utiliser la commande \hgcmd{pull} pour apporter les 1.116 @@ -591,16 +621,20 @@ 1.117 1.118 Nous avons jusqu'à maintenant grossièrement définie la relation 1.119 entre un dépôt et un espace de travail. La commande \hgcmd{pull} que 1.120 -nous avons exécuter dans la section~\ref{sec:tour:pull} a apportée 1.121 +nous avons exécutée dans la section~\ref{sec:tour:pull} a apporté 1.122 des modifications, que nous avons vérifiées, dans notre dépôt, mais 1.123 il n'y a aucune trace de ces modifications dans notre espace de travail. 1.124 En effet, \hgcmd{pull} ne touche pas (par défaut) à l'espace de 1.125 travail. C'est la commande \hgcmd{update} qui s'en charge. 1.126 \interaction{tour.update} 1.127 1.128 -Il peut sembler un peu étrange que la commande \hgcmd{pull} ne met 1.129 +Il peut sembler un peu étrange que la commande \hgcmd{pull} ne mette 1.130 pas à jour l'espace de travail automatiquement. Il y a en fait une 1.131 +<<<<<<< local 1.132 très bonne raison à cela : vous pouvez utilisez la commande 1.133 +======= 1.134 +très bonne raison à cela: vous pouvez utiliser la commmande 1.135 +>>>>>>> other 1.136 \hgcmd{update} pour mettre à jour votre espace de travail à l'état 1.137 dans lequel il était à \emph{n'importe quelle révision} de l'historique 1.138 du dépôt. Si vous aviez un espace de travail contenant une ancienne 1.139 @@ -610,30 +644,47 @@ 1.140 1.141 Néanmoins, comme les opérations de \textit{pull} sont très souvent 1.142 suivies d'un \textit{update}, Mercurial vous permet de combiner les 1.143 -deux aisément passant l'option \hgopt{pull}{-u} à la commande 1.144 +deux aisément en passant l'option \hgopt{pull}{-u} à la commande 1.145 \hgcmd{pull} 1.146 \begin{codesample2} 1.147 hg pull -u 1.148 \end{codesample2} 1.149 1.150 Si vous étudiez de nouveau la sortie de la commande \hgcmd{pull} dans 1.151 +<<<<<<< local 1.152 la section~\ref{sec:tour:pull} quand nous l'avons exécuté sans l'option 1.153 \hgopt{pull}{-u}, vous pouvez constater qu'elle a affiché le rappel assez 1.154 utile comme quoi vous devez encore effectuer une opération pour mettre à jour 1.155 +======= 1.156 +la section~\ref{sec:tour:pull} quand nous l'avons exécutée sans l'option 1.157 +\hgopt{pull}{-u}, vous pouvez constater qu'elle a affiché un rappel assez 1.158 +utile : vous devez encore effectuer une opération pour mettre à jour 1.159 +>>>>>>> other 1.160 votre espace de travail: 1.161 \begin{codesample2} 1.162 (run 'hg update' to get a working copy) 1.163 \end{codesample2} 1.164 1.165 +<<<<<<< local 1.166 Pour découvrir sur quelle révision de l'espace de travail on est, utilisez 1.167 +======= 1.168 +Pour découvrir quelle révision de l'espace de travail en est où, utiliser 1.169 +>>>>>>> other 1.170 la commande \hgcmd{parents}. 1.171 \interaction{tour.parents} 1.172 Si vous regardez de nouveau le dessin~\ref{fig:tour-basic:history}, vous 1.173 +<<<<<<< local 1.174 verrez les flèches reliant entre eux les \textit{changeset}. Le nœud 1.175 d'où la flèche \emph{part} est dans chaque cas un parent, 1.176 et le nœud où la flèche \emph{arrive} est un enfant. 1.177 +======= 1.178 +verrez que les flèches reliant les \textit{changeset} entre eux. Le noeud 1.179 +dont la flèche mène \emph{de quelquepart} est dans chaque cas un parent, 1.180 +et le node dont la flèche mène \emph{vers quelquepart} est un enfant. %%%TODO: vers quelque part ? 1.181 +>>>>>>> other 1.182 L'espace de travail a un parent de la même manière, c'est ce \textit{changeset} 1.183 que l'espace de travail contient à ce moment. 1.184 +%%%TODO : difficile à comprendre : l'espace de travail a un parent, de la même manière, c'est ce changeset que l'espace... 1.185 1.186 Pour mettre à jour l'espace de travail d'une révision particulière, 1.187 indiquez un numéro de révision ou un \textit{changeset~ID} à la commande 1.188 @@ -641,8 +692,13 @@ 1.189 \interaction{tour.older} 1.190 Si vous ne précisez pas de manière explicite de numéro de révision 1.191 la commande \hgcmd{update} mettra à jour votre espace de travail avec 1.192 +<<<<<<< local 1.193 le contenu de la révision \textit{tip}, comme montré dans l'exemple 1.194 ci-dessus lors du second appel à \hgcmd{update}. 1.195 +======= 1.196 +le contenu de la révsion \textit{tip}, comme montrée dans l'exemple 1.197 +ci dessus lors du second appel à \hgcmd{update}. 1.198 +>>>>>>> other 1.199 1.200 \subsection{Transférer les modifications à un autre dépôt} 1.201 1.202 @@ -653,7 +709,7 @@ 1.203 ``pousser'' tout simplement} nos modifications. 1.204 \interaction{tour.clone-push} 1.205 La commande \hgcmd{outgoing} nous indique quels changements nous 1.206 -allons transférer vers l'autre serveyr. 1.207 +allons transférer vers l'autre serveur ? 1.208 \interaction{tour.outgoing} 1.209 Et la commande \hgcmd{push} effectue réellement le transfert. 1.210 \interaction{tour.push} 1.211 @@ -670,8 +726,13 @@ 1.212 1.213 \subsection{Partager ses modifications à travers le réseau} 1.214 1.215 +<<<<<<< local 1.216 Les commandes que nous avons étudiés dans les sections précédentes 1.217 ne se limitent pas aux dépôt locaux. Chacune commande fonctionne de la même 1.218 +======= 1.219 +Les commandes que nous avons étudiées dans les sections précédentes 1.220 +ne sont pas limitées aux dépôt locaux. Chacune fonctionne de la même 1.221 +>>>>>>> other 1.222 manière à travers une connexion réseau, il suffit de lui passer une 1.223 URL à la place d'un chemin de fichier local. 1.224