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