hgbook

diff fr/preface.tex @ 921:547d3aa25ef0

Initial copy from the english version, added package for french input.
author Romain PELISSE <romain.pelisse@atosorigin.com>
date Thu Feb 05 12:37:03 2009 +0100 (2009-02-05)
parents en/preface.tex@9bba958be4c6
children f5d009f9e8e0
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/fr/preface.tex	Thu Feb 05 12:37:03 2009 +0100
     1.3 @@ -0,0 +1,69 @@
     1.4 +\chapter*{Préface}
     1.5 +\addcontentsline{toc}{chapter}{Preface}
     1.6 +\label{chap:preface}
     1.7 +
     1.8 +La gestion de source distribué est encore un territoire peu exploré
     1.9 +et par conséquent a grandis très rapidement grâce à la volonté de
    1.10 +ses explorateurs.
    1.11 +
    1.12 +Je rédige un libre sur ce sujet car je crois que c'est un sujet 
    1.13 +important qui mérite bien un guide du ``terrain''. J'ai choisi d'écrire
    1.14 +un livre sur Mercurial car c'est l'outil le plus simple pour découvrir
    1.15 +ce nouveau monde et que, en outre, il répond très bien au besoin de
    1.16 +réels environements, là où d'autres outils de gestion de source n'y
    1.17 +parviennent pas.
    1.18 +
    1.19 +\section{Cet ouvrage est un travail en cours}
    1.20 +
    1.21 +Je publie ce livre tout en continuant à l'écrire, dans l'espoir qu'il
    1.22 +vous sera utile. J'espère aussi que les lecteurs pourront ainsi contribuer
    1.23 +si ils souhaitent.
    1.24 +
    1.25 +\section{A propros des exemples de ce livre}
    1.26 +
    1.27 +Ce livre a une approche particulière des extrait de code. Ceci sont 
    1.28 +toujours ``dynamique''---chacun est le résultat d'un script shell qui
    1.29 +exécute les commandes mercurial que vous voyez. Chaque fois qu'une 
    1.30 +image du livre est construite tout les scripts d'exemple sont exécutés
    1.31 +automatiquement, et les résultats comparés à ceux attendus.
    1.32 +
    1.33 +Cette approche a l'avantage de garantir que les exemples sont toujours
    1.34 +juste; ils montrent \emph{exactement} le comportement de la version de
    1.35 +Mercurial spécifié dans la couverture de ce livre. Si je met à jour cette
    1.36 +version, et que les commandes changent, la génération du livre échouera.
    1.37 +
    1.38 +Il y a un petit désavantage à cette approche, qui que les dates et les
    1.39 +temps onl
    1.40 +
    1.41 +There is a small disadvantage to this approach, which is that the
    1.42 +dates and times you'll see in examples tend to be ``squashed''
    1.43 +together in a way that they wouldn't be if the same commands were
    1.44 +being typed by a human.  Where a human can issue no more than one
    1.45 +command every few seconds, with any resulting timestamps
    1.46 +correspondingly spread out, my automated example scripts run many
    1.47 +commands in one second.
    1.48 +
    1.49 +As an instance of this, several consecutive commits in an example can
    1.50 +show up as having occurred during the same second.  You can see this
    1.51 +occur in the \hgext{bisect} example in section~\ref{sec:undo:bisect},
    1.52 +for instance.
    1.53 +
    1.54 +So when you're reading examples, don't place too much weight on the
    1.55 +dates or times you see in the output of commands.  But \emph{do} be
    1.56 +confident that the behaviour you're seeing is consistent and
    1.57 +reproducible.
    1.58 +
    1.59 +\section{Colophon---this book is Free}
    1.60 +
    1.61 +This book is licensed under the Open Publication License, and is
    1.62 +produced entirely using Free Software tools.  It is typeset with
    1.63 +\LaTeX{}; illustrations are drawn and rendered with
    1.64 +\href{http://www.inkscape.org/}{Inkscape}.
    1.65 +
    1.66 +The complete source code for this book is published as a Mercurial
    1.67 +repository, at \url{http://hg.serpentine.com/mercurial/book}.
    1.68 +
    1.69 +%%% Local Variables: 
    1.70 +%%% mode: latex
    1.71 +%%% TeX-master: "00book"
    1.72 +%%% End: