hgbook

changeset 939:99b93caf2db2

Work in progress on tour-basic
author Romain PELISSE <belaran@gmail.com>
date Mon Feb 16 14:53:05 2009 +0100 (2009-02-16)
parents 651aa8fd9882
children 1dc7475ccab1 f346c59abb60
files fr/tour-basic.tex
line diff
     1.1 --- a/fr/tour-basic.tex	Mon Feb 16 10:42:23 2009 +0100
     1.2 +++ b/fr/tour-basic.tex	Mon Feb 16 14:53:05 2009 +0100
     1.3 @@ -221,57 +221,63 @@
     1.4  
     1.5  \subsection{Changesets, révisions, et discuter avec les autres}
     1.6  
     1.7 -As English is a notoriously sloppy language, and computer science has
     1.8 -a hallowed history of terminological confusion (why use one term when
     1.9 -four will do?), revision control has a variety of words and phrases
    1.10 -that mean the same thing.  If you are talking about Mercurial history
    1.11 -with other people, you will find that the word ``changeset'' is often
    1.12 -compressed to ``change'' or (when written) ``cset'', and sometimes a
    1.13 -changeset is referred to as a ``revision'' or a ``rev''.
    1.14 -
    1.15 -While it doesn't matter what \emph{word} you use to refer to the
    1.16 -concept of ``a~changeset'', the \emph{identifier} that you use to
    1.17 -refer to ``a~\emph{specific} changeset'' is of great importance.
    1.18 -Recall that the \texttt{changeset} field in the output from
    1.19 -\hgcmd{log} identifies a changeset using both a number and a
    1.20 -hexadecimal string.
    1.21 +Comme l'anglais est réputé pour un langage maladroit, et que l'informatique
    1.22 +est la source de bien des erreurs terminologique (pourquoi utiliser un
    1.23 +seul terme quand quatre feront l'affaire ?), la gestion de version a une
    1.24 +variété de mot et de phrases qui veulent dire la même chose. Si vous 
    1.25 +parlez à quelqu'un de l'historique de Mercurial à d'autres personnes, 
    1.26 +vous constaterez que souvent le mot ``\textit{changeset}'' est compressé 
    1.27 +en juste ``change'' ou (à l'écrit) ``cset'', et même parfois un 
    1.28 +\textit{changeset} simplement ``révision'', abrégé en ``rev''.
    1.29 +
    1.30 +Bien que le \emph{mot} que vous utilisez pour désigner le concept de
    1.31 +\textit{changeset} importe peu, l'\emph{identifiant} que vous utilisez
    1.32 +pour désigner un \emph{spécifique} \textit{spécifique} a une grande
    1.33 +importance. Rappelez vous que le \textit{changeset} affiché par la 
    1.34 +commande \hgcmd{log} identifie un \textit{changeset} à la fois avec
    1.35 +un numéro de révision et une séquence hexadécimale.
    1.36 +
    1.37  \begin{itemize}
    1.38 -\item The revision number is \emph{only valid in that repository},
    1.39 -\item while the hex string is the \emph{permanent, unchanging
    1.40 -    identifier} that will always identify that exact changeset in
    1.41 -  \emph{every} copy of the repository.
    1.42 +\item Le numéro de révision est \emph{seulement valable dans ce dépôt},
    1.43 +\item alors que la séquence hexadécimale est un \emph{identifiant 
    1.44 +	permanent, et immutable } qui pourra toujours être associé à %%%TODO: Immutable ? Is this french ?
    1.45 +	\textit{changeset} exacte de \emph{chaque} copie de votre dépôt.
    1.46  \end{itemize}
    1.47 -This distinction is important.  If you send someone an email talking
    1.48 -about ``revision~33'', there's a high likelihood that their
    1.49 -revision~33 will \emph{not be the same} as yours.  The reason for this
    1.50 -is that a revision number depends on the order in which changes
    1.51 -arrived in a repository, and there is no guarantee that the same
    1.52 -changes will happen in the same order in different repositories.
    1.53 -Three changes $a,b,c$ can easily appear in one repository as $0,1,2$,
    1.54 -while in another as $1,0,2$.
    1.55 -
    1.56 -Mercurial uses revision numbers purely as a convenient shorthand.  If
    1.57 -you need to discuss a changeset with someone, or make a record of a
    1.58 -changeset for some other reason (for example, in a bug report), use
    1.59 -the hexadecimal identifier.
    1.60 -
    1.61 -\subsection{Viewing specific revisions}
    1.62 -
    1.63 -To narrow the output of \hgcmd{log} down to a single revision, use the
    1.64 -\hgopt{log}{-r} (or \hgopt{log}{--rev}) option.  You can use either a
    1.65 -revision number or a long-form changeset identifier, and you can
    1.66 -provide as many revisions as you want.  \interaction{tour.log-r}
    1.67 -
    1.68 -If you want to see the history of several revisions without having to
    1.69 -list each one, you can use \emph{range notation}; this lets you
    1.70 -express the idea ``I want all revisions between $a$ and $b$,
    1.71 -inclusive''.
    1.72 +
    1.73 +La distinction est importante. Si vous envoyez un email à quelqu'un en
    1.74 +parlant de la ``révision 33'', il est très probable que sa révision~33
    1.75 +\emph{ne sera pas la même} que la votre. La raison de ceci est que le
    1.76 +numéro de révision dépend de l'ordre dans lequel les modifications sont
    1.77 +arrivés dans le dépôt, et il n'y a aucune garantie que les mêmes changements
    1.78 +soient arrivés dans le même ordre dans différents dépôts. Trois modifications
    1.79 +$a,b,c$ peuvent aisément apparaitre dans un dépôt comme $0,1,2$, et dans
    1.80 +un autre comme $1,0,2$.
    1.81 +
    1.82 +Mercurial utilise les numéro de révision uniquement comme des raccourcis
    1.83 +pratique. Si vous devez disctuer d'un \textit{changeset} avec quelqu'un, 
    1.84 +our faire un enregistrement d'un \textit{changeset} pour une quelquonque
    1.85 +raison (par exemple, un rapport de \textit{bug}), utilisez la séquence
    1.86 +hexadécimale.
    1.87 +
    1.88 +\subsection{Afficher une révision spécifique}
    1.89 +
    1.90 +Pour réduire la sortie de \hgcmd{log} à une seule révision, utilisez
    1.91 +l'option \hgopt{log}{-r} (ou \hgopt{log}{--rev}). Vous pouvez utiser
    1.92 +le numéro de révision ou la séquence hexadécimal comme identifiant, et 
    1.93 +vous demandez autant de révisions que vous le souhaitez. 
    1.94 +\interaction{tour.log-r}
    1.95 +
    1.96 +Si vous voulez voir l'historique de plusieurs révisions sans avoir à 
    1.97 +les énumérer, vous pouvez utiliser la \emph{\textit{range notation}}
    1.98 +\footnote{NdT: Il n'est pas aisé de traduire ce terme, donc je le 
    1.99 +laisse en anglais} qui vous permet d'exprimer l'idée ``je veux toutes
   1.100 +les révisions entre $a$ et $b$, inclus''.
   1.101  \interaction{tour.log.range}
   1.102 -Mercurial also honours the order in which you specify revisions, so
   1.103 -\hgcmdargs{log}{-r 2:4} prints $2,3,4$ while \hgcmdargs{log}{-r 4:2}
   1.104 -prints $4,3,2$.
   1.105 -
   1.106 -\subsection{More detailed information}
   1.107 +Mercurial respecte aussi l'ordre dans lequel vous spécifier les 
   1.108 +révisions, ainsi \hgcmdargs{log}{-r 2:4} affichera $2,3,4$ alors que 
   1.109 +\hgcmdargs{log}{-r 4:2} affichera $4,3,2$.
   1.110 +
   1.111 +\subsection{Informations détaillées}
   1.112  
   1.113  While the summary information printed by \hgcmd{log} is useful if you
   1.114  already know what you're looking for, you may need to see a complete