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