hgbook

view fr/preface.tex @ 954:2cd5d582c956

Work in progress + typos
author Romain PELISSE <belaran@gmail.com>
date Wed Feb 18 20:38:12 2009 +0100 (2009-02-18)
parents d7159547e28a
children
line source
1 \chapter*{Préface}
2 \addcontentsline{toc}{chapter}{Préface}
3 \label{chap:preface}
5 La gestion de source distribuée est encore un territoire peu exploré
6 et qui, par conséquent, a grandi très rapidement grâce à la seule
7 volonté de ses explorateurs.
9 Je rédige un livre sur ce sujet car je crois que c'est un sujet
10 important qui mérite bien un guide du ``terrain''. J'ai choisi d'écrire
11 ce livre sur Mercurial car c'est l'outil le plus simple pour découvrir
12 ce nouveau monde et qu'en outre, il répond très bien au besoin de
13 réels environnements, là où d'autres outils de gestion de source n'y
14 parviennent pas.
16 \section{Cet ouvrage est un travail en cours}
18 Je publie ce livre tout en continuant à l'écrire, dans l'espoir qu'il
19 vous sera utile. J'espère aussi que les lecteurs pourront ainsi y contribuer
20 si ils le souhaitent.
22 \section{À propros des exemples de ce livre}
24 Ce livre a une approche particulière des exemples d'exécution. Ils sont
25 toujours ``dynamiques''---chacun est le résultat d'un script shell qui
26 exécute les commandes Mercurial que vous voyez. Chaque fois qu'une
27 image du livre est construite à partir des sources, tous les scripts d'exemple
28 sont exécutés automatiquement, et les résultats comparés à ceux attendus.
30 Cette approche a l'avantage de garantir que les exemples sont toujours
31 justes ; ils montrent \emph{exactement} le comportement de la version de
32 Mercurial spécifiée dans la couverture de ce livre. Si je mets à jour cette
33 version, et que les commandes changent, la génération du livre échouera.
35 Il y a un petit désavantage à cette approche, les dates et les
36 durées que vous verrez dans ces exemples ont tendances à être
37 ``réduits'' de manière très différente d'une exécution manuelle. Un être humain
38 ne peut exécuter qu'une commande toutes les secondes, alors que mes scripts
39 automatisés en exécutent plusieurs en une seule seconde.
41 Ainsi, en une seule seconde, plusieurs ``commits'' peuvent avoir lieu
42 au sein d'un exemple. Vous le constatez, entre autres, dans les
43 exemples sur \hgext{bisect}, dans la section~\ref{sec:undo:bisect}.
45 En conséquence, quand vous lisez les exemples, n'accordez pas trop
46 d'importance aux dates et aux durées d'exécution des commandes. Mais
47 \emph{soyez sûr} que le comportement que vous voyez est cohérent et
48 reproductible.
50 \section{Colophon---Cet ouvrage est libre}
52 Ce livre est publié sous la licence ``Open Publication License''
53 \footnote{Pour plus de renseignements :
54 \url{http://opencontent.org/openpub/}{Open Publication License} },
55 et est construit uniquement à l'aide de logiciels libres. Il est mis
56 en forme avec \LaTex{}; et les illustrations sont réalisées avec
57 \href{http://www.inkscape.org/}{Inkscape}.
59 L'ensemble des fichiers sources de cet ouvrage est publié dans un
60 dépot mercurial \url{http://hg.serpentine.com/mercurial/book}.
62 %%% Local Variables:
63 %%% mode: latex
64 %%% TeX-master: "00book"
65 %%% End: