1 \chapter*{Préface}

2 \addcontentsline{toc}{chapter}{Preface}

3 \label{chap:preface}

4

5 La gestion de source distribué est encore un territoire peu exploré

6 et par conséquent a grandis très rapidement grâce à la volonté de

7 ses explorateurs.

8

9 Je rédige un libre 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 un livre sur Mercurial car c'est l'outil le plus simple pour découvrir

12 ce nouveau monde et que, en outre, il répond très bien au besoin de

13 réels environements, là où d'autres outils de gestion de source n'y

14 parviennent pas.

15

16 \section{Cet ouvrage est un travail en cours}

17

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 contribuer

20 si ils souhaitent.

21

22 \section{A propros des exemples de ce livre}

23

24 Ce livre a une approche particulière des extrait de code. Ceci sont

25 toujours ``dynamique''---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 tout les scripts d'exemple sont exécutés

28 automatiquement, et les résultats comparés à ceux attendus.

29

30 Cette approche a l'avantage de garantir que les exemples sont toujours

31 juste; ils montrent \emph{exactement} le comportement de la version de

32 Mercurial spécifié dans la couverture de ce livre. Si je met à jour cette

33 version, et que les commandes changent, la génération du livre échouera.

34

35 Il y a un petit désavantage à cette approche, qui que les dates et les

36 temps onl

37

38 There is a small disadvantage to this approach, which is that the

39 dates and times you'll see in examples tend to be ``squashed''

40 together in a way that they wouldn't be if the same commands were

41 being typed by a human. Where a human can issue no more than one

42 command every few seconds, with any resulting timestamps

43 correspondingly spread out, my automated example scripts run many

44 commands in one second.

45

46 As an instance of this, several consecutive commits in an example can

47 show up as having occurred during the same second. You can see this

48 occur in the \hgext{bisect} example in section~\ref{sec:undo:bisect},

49 for instance.

50

51 So when you're reading examples, don't place too much weight on the

52 dates or times you see in the output of commands. But \emph{do} be

53 confident that the behaviour you're seeing is consistent and

54 reproducible.

55

56 \section{Colophon---this book is Free}

57

58 This book is licensed under the Open Publication License, and is

59 produced entirely using Free Software tools. It is typeset with

60 \LaTeX{}; illustrations are drawn and rendered with

61 \href{http://www.inkscape.org/}{Inkscape}.

62

63 The complete source code for this book is published as a Mercurial

64 repository, at \url{http://hg.serpentine.com/mercurial/book}.

65

66 %%% Local Variables:

67 %%% mode: latex

68 %%% TeX-master: "00book"

69 %%% End: