hgbook
changeset 955:5abf0e11ce7e
Relecture et typographie
author | "Hugues Frachon" <huguesfrachon@gmail.com> |
---|---|
date | Fri Feb 20 09:39:02 2009 +0100 (2009-02-20) |
parents | 2cd5d582c956 |
children | f42151a42f9e |
files | fr/tour-basic.tex |
line diff
1.1 --- a/fr/tour-basic.tex Wed Feb 18 20:38:12 2009 +0100 1.2 +++ b/fr/tour-basic.tex Fri Feb 20 09:39:02 2009 +0100 1.3 @@ -459,7 +459,7 @@ 1.4 définir la valeur de l'élément \texttt{username} dans la section 1.5 \texttt{ui}''. Une section continue jusqu'à ce qu'une nouvelle 1.6 commence, ou que la fin du fichier soit atteinte. Mercurial ignore 1.7 -les lignes vide et traite tout texte situé à la suite d'un 1.8 +les lignes vides et traite tout texte situé à la suite d'un 1.9 ``\texttt{\#}'' jusqu'à la fin de la ligne comme un commentaire. 1.10 1.11 \subsubsection{Choisir un nom d'utilisateur} 1.12 @@ -467,14 +467,14 @@ 1.13 Vous pouvez utiliser n'importe quelle valeur pour votre \texttt{username}, 1.14 car cette information est destinée à d'autres personnes et non à être 1.15 interprétée par Mercurial. La convention que la plupart des personnes 1.16 -suivent est d'utiliser leurs noms suivies de leurs adresses emails, 1.17 +suivent est d'utiliser leur nom suivi de leur adresse email, 1.18 comme montrée ci dessus: 1.19 1.20 \begin{note} 1.21 Le mécanisme interne du serveur \textit{web} intégré à Mercurial, 1.22 masque les adresses emails, pour rendre plus difficile leurs 1.23 récupérations par les outils utilisés par les \textit{spammmers}. 1.24 - Ceci réduit la probabilité que vous receviez encore plus de 1.25 + Ceci réduit la probabilité que de recevoir encore plus de 1.26 \textit{spam} si vous vous publiez un dépôt sur internet. 1.27 \end{note} 1.28 1.29 @@ -483,20 +483,20 @@ 1.30 Lorsque l'on effectue une opération de \textit{commit}, Mercurial 1.31 lance automatiquement un éditeur de texte pour permettre de saisir 1.32 un message qui décrira les modifications effectuées dans ce 1.33 -\textit{changeset}. Ce message est nommée le \emph{message de 1.34 +\textit{changeset}. Ce message est nommé le \emph{message de 1.35 \textit{commit}}. Ce sera un enregistrement pour tout lecteur 1.36 expliquant le pourquoi et le comment de vos modifications, et il sera 1.37 affiché par la commande \hgcmd{log}. 1.38 \interaction{tour.commit} 1.39 1.40 -L'éditor que la commande \hgcmd{commit} déclenche ne contiendra 1.41 +L'éditeur que la commande \hgcmd{commit} déclenche ne contiendra 1.42 qu'une ligne vide suivi d'un certain nombre de lignes commençant 1.43 par ``\texttt{HG:}''. 1.44 \begin{codesample2} 1.45 \emph{empty line} 1.46 HG: changed hello.c 1.47 \end{codesample2} 1.48 -Mercurial ignore les lignes qui commence avec ``\texttt{HG:}'', il 1.49 +Mercurial ignore les lignes qui commencent avec ``\texttt{HG:}'', il 1.50 ne les utilise que pour nous indiquer quels fichiers modifiés il se 1.51 prépare à \textit{commiter}. Modifier ou effacer ces lignes n'a 1.52 aucune conséquence sur l'opération de \textit{commit}. 1.53 @@ -505,7 +505,7 @@ 1.54 1.55 Comme \hgcmd{log} n'affiche que la première ligne du message de 1.56 \textit{commit} par défaut, il est souvent considéré comme une bonne 1.57 -pratique de rédiger des messages de \textit{commit} qui rentre que 1.58 +pratique de rédiger des messages de \textit{commit} qui n'entrent que 1.59 sur une seule ligne. Voilà un exemple concret de message de 1.60 \textit{commit} qui \emph{ne suit pas} cette directive, et qui a donc 1.61 un résumé peu lisible. 1.62 @@ -516,35 +516,35 @@ 1.63 summary: include buildmeister/commondefs. Add an exports and install 1.64 \end{codesample2} 1.65 1.66 -A ce sujet, il faut noter qu'il n'existe pas de règle absolu dans ce 1.67 +A ce sujet, il faut noter qu'il n'existe pas de règle absolue dans ce 1.68 domaine. Mercurial lui-même n'interprète pas les contenus des messages 1.69 de \textit{commit}, ainsi votre projet est libre de concevoir différentes 1.70 -politiques de formattage des messages. 1.71 +politiques de formatage des messages. 1.72 1.73 Ma préférence personnelle va au message court, mais informatif, qui offre 1.74 -des précisions supplémentaires à ce que pourrait m'apprendre une commande 1.75 +des précisions supplémentaires par rapport à ce que pourrait m'apprendre une commande 1.76 \hgcmdargs{log}{--patch}. 1.77 1.78 \subsection{Annuler un \textit{commit}} 1.79 1.80 Si, en rédigeant le message, vous décidez que finalement vous ne 1.81 -voulez pas effectuer ce \textit{commit}, il suffit de simplement quitter 1.82 +voulez pas effectuer ce \textit{commit}, il suffit de quitter simplement 1.83 l'éditeur sans sauver. Ceci n'aura aucune conséquence sur le dépôt ou 1.84 les fichiers de l'espace de travail. 1.85 1.86 -Si vous exécuter la commande \hgcmd{commit} sans aucun arguments, elle 1.87 +Si vous exécutez la commande \hgcmd{commit} sans aucun argument, elle 1.88 enregistre toutes les modifications que vous avez faites, comme le montre 1.89 -la commande \hgcmd{status} et \hgcmd{diff}. 1.90 +les commandes \hgcmd{status} et \hgcmd{diff}. 1.91 1.92 \subsection{Admirer votre travail} 1.93 1.94 Une fois que votre \textit{commit} est terminé, vous pouvez utiliser 1.95 la commande \hgcmd{tip} pour afficher le \textit{changeset} que nous 1.96 venons de créer. Cette commande produit une sortie à l'écran qui est 1.97 -identique à celle du \hgcmd{log}, maios qui n'affiche que la dernière 1.98 +identique à celle du \hgcmd{log}, mais qui n'affiche que la dernière 1.99 révision du dépôt. 1.100 \interaction{tour.tip} 1.101 -On fait courament référénce à la dernière révision du dépôt comme 1.102 +On fait couramment référénce à la dernière révision du dépôt comme 1.103 étant la révision \textit{tip}, ou plus simplement le \textit{tip}. 1.104 1.105 \section{Partager ses modifications} 1.106 @@ -560,7 +560,7 @@ 1.107 1.108 Pour commencer, construisons un clône de notre dépôt \dirname{hello} 1.109 qui ne contiendra pas le changement que nous venons d'effectuer. Nous 1.110 -l'appelerons notre dépôt temporaire \dirname{hello-pull}. 1.111 +appelerons notre dépôt temporaire \dirname{hello-pull}. 1.112 \interaction{tour.clone-pull} 1.113 1.114 Nous allons utiliser la commande \hgcmd{pull} pour apporter les 1.115 @@ -569,38 +569,38 @@ 1.116 a quelquechose d'un peu effrayant. Mercurial propose donc une 1.117 commande \hgcmd{incoming} qui permet de savoir quelles modifications 1.118 la commande \hgcmd{pull} \emph{pourrait} entraîner dans notre dépôt, 1.119 -et ceci sans effectuant réellement de modification dessus. 1.120 +et ceci sans effectuer réellement de modification dessus. 1.121 \interaction{tour.incoming} 1.122 -(Bien évidement, quelqu'un pourrait peut ajouter des modifications 1.123 +(Bien évidement, quelqu'un pourrait ajouter des modifications 1.124 supplémentaires sur le dépôt que nous étudions avec \hgcmd{incoming}, 1.125 avant que nous ayons effectué notre \hgcmd{pull}, avec comme 1.126 triste conséquence que nous aurons récupéré des modifications que 1.127 nous n'attendions pas.) 1.128 1.129 -Apporter les modifications rapatriées dans un dépôt sera résume donc 1.130 +Apporter les modifications rapatriées dans un dépôt se résume donc 1.131 à exécuter la commande \hgcmd{pull}, et préciser depuis quel dépôt 1.132 effectuer le \hgcmd{pull}. 1.133 \interaction{tour.pull} 1.134 1.135 Comme vous le voyez avec une sortie avant et après de la commande 1.136 \hgcmd{tip}, nous avons réussi à récupérer aisément les modifications 1.137 -dans notre dépôt. Il reste néanmoins quelquechose à faire avant de 1.138 +dans notre dépôt. Il reste néanmoins quelque chose à faire avant de 1.139 placer ces modifications dans l'espace de travail. 1.140 1.141 \subsection{Mise à jour de l'espace de travail} 1.142 1.143 -Nous avons jusqu'à maintenant que grossièrement définie la relation 1.144 +Nous avons jusqu'à maintenant grossièrement définie la relation 1.145 entre un dépôt et un espace de travail. La commande \hgcmd{pull} que 1.146 -nous avons exécuter dans la section~\ref{sec:tour:pull} a apportée 1.147 +nous avons exécutée dans la section~\ref{sec:tour:pull} a apporté 1.148 des modifications, que nous avons vérifiées, dans notre dépôt, mais 1.149 -il n'ya aucune trace de ces modifications dans notre espace de travail. 1.150 +il n'y a aucune trace de ces modifications dans notre espace de travail. 1.151 En effet, \hgcmd{pull} ne touche pas (par défaut) à l'espace de 1.152 travail. C'est la commande \hgcmd{update} qui s'en charge. 1.153 \interaction{tour.update} 1.154 1.155 -Il peut sembler un peu étrange que la commande \hgcmd{pull} ne met 1.156 +Il peut sembler un peu étrange que la commande \hgcmd{pull} ne mette 1.157 pas à jour l'espace de travail automatiquement. Il y a en fait une 1.158 -très bonne raison à cela: vous pouvez utilisez la commmande 1.159 +très bonne raison à cela: vous pouvez utiliser la commmande 1.160 \hgcmd{update} pour mettre à jour votre espace de travail à l'état 1.161 dans lequel il était à \emph{n'importe quelle révision} de l'historique 1.162 du dépôt. Si vous aviez un espace de travail contenant une ancienne 1.163 @@ -610,39 +610,39 @@ 1.164 1.165 Néanmoins, commme les opérations de \textit{pull} sont très souvent 1.166 suivies d'un \textit{update}, Mercurial vous permet de combiner les 1.167 -deux aisément passant l'option \hgopt{pull}{-u} à la commande 1.168 +deux aisément en passant l'option \hgopt{pull}{-u} à la commande 1.169 \hgcmd{pull} 1.170 \begin{codesample2} 1.171 hg pull -u 1.172 \end{codesample2} 1.173 1.174 Si vous étudiez de nouveau la sortie de la commande \hgcmd{pull} dans 1.175 -la section~\ref{sec:tour:pull} quand nous l'avons exécuter sans l'option 1.176 -\hgopt{pull}{-u}, vous pouvez constater qu'elle a afficher un rappel assez 1.177 -utile que vous devez encore effectuer une opération pour mettre à jour 1.178 +la section~\ref{sec:tour:pull} quand nous l'avons exécutée sans l'option 1.179 +\hgopt{pull}{-u}, vous pouvez constater qu'elle a affiché un rappel assez 1.180 +utile : vous devez encore effectuer une opération pour mettre à jour 1.181 votre espace de travail: 1.182 \begin{codesample2} 1.183 (run 'hg update' to get a working copy) 1.184 \end{codesample2} 1.185 1.186 -Pour découvrir quelle révision de l'espace de travail en est, utiliser 1.187 +Pour découvrir quelle révision de l'espace de travail en est où, utiliser 1.188 la commande \hgcmd{parents}. 1.189 \interaction{tour.parents} 1.190 Si vous regardez de nouveau le dessin~\ref{fig:tour-basic:history}, vous 1.191 -verrez que les flèches reliant entreux les \textit{changeset}. Le noeud 1.192 +verrez que les flèches reliant les \textit{changeset} entre eux. Le noeud 1.193 dont la flèche mène \emph{de quelquepart} est dans chaque cas un parent, 1.194 -et le node dont la flèche mène \emph{à quelquepart} est un enfant. 1.195 +et le node dont la flèche mène \emph{vers quelquepart} est un enfant. %%%TODO: vers quelque part ? 1.196 L'espace de travail a un parent de la même manière, c'est ce \textit{changeset} 1.197 que l'espace de travail contient à ce moment. 1.198 +%%%TODO : difficile à comprendre : l'espace de travail a un parent, de la même manière, c'est ce changeset que l'espace... 1.199 1.200 Pour mettre à jour l'espace de travail d'une révision particulière, 1.201 indiquer un numéro de révision ou un \textit{changeset~ID} à la commande 1.202 \hgcmd{update}. 1.203 \interaction{tour.older} 1.204 Si vous ne précisez pas de manière explicite de numéro de révision 1.205 - 1.206 la commande \hgcmd{update} mettra à jour votre espace de travail avec 1.207 -le contenu de la révsion \textit{tip}, comme montré dans l'exemple 1.208 +le contenu de la révsion \textit{tip}, comme montrée dans l'exemple 1.209 ci dessus lors du second appel à \hgcmd{update}. 1.210 1.211 \subsection{Transférer les modifications à un autre dépôt} 1.212 @@ -654,7 +654,7 @@ 1.213 ``pousser'' tout simplement} nos modifications. 1.214 \interaction{tour.clone-push} 1.215 La commande \hgcmd{outgoing} nous indique quels changements nous 1.216 -allons transférer vers l'autre serveyr. 1.217 +allons transférer vers l'autre serveur ? 1.218 \interaction{tour.outgoing} 1.219 Et la commande \hgcmd{push} effectue réellement le transfert. 1.220 \interaction{tour.push} 1.221 @@ -671,8 +671,8 @@ 1.222 1.223 \subsection{Partager ses modifications à travers le réseau} 1.224 1.225 -Les commandes que nous avons étudiés dans les sections précédentes 1.226 -ne sont pas limite aux dépôt locaux. Chacune fonction de la même 1.227 +Les commandes que nous avons étudiées dans les sections précédentes 1.228 +ne sont pas limitées aux dépôt locaux. Chacune fonctionne de la même 1.229 manière à travers une connexion réseau, il suffit de lui passer une 1.230 URL et non un chemin de fichier local. 1.231