hgbook

view fr/ch00-preface.xml @ 964:6b680d569bb4

find changesets by author, revision, files, or words in the commit message
deleting a bunch of files not longer necessary to build the documentation.
Adding missing newly files needed to build the documentation
author Romain PELISSE <belaran@gmail.com>
date Sun Aug 16 04:58:01 2009 +0200 (2009-08-16)
parents
children
line source
1 <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
2
3 <para>\chapter*{Préface}
4 \addcontentsline{toc}{chapter}{Préface}
5 \label{chap:preface}</para>
6
7 <para>La gestion de source distribuée est encore un territoire peu exploré
8 et qui, par conséquent, a grandi très rapidement grâce à la seule
9 volonté de ses explorateurs.</para>
10
11 <para>Je rédige un livre sur ce sujet car je crois que c'est un sujet
12 important qui mérite bien un guide du <quote>terrain</quote>. J'ai choisi d'écrire
13 ce livre sur Mercurial car c'est l'outil le plus simple pour découvrir
14 ce nouveau monde et qu'en outre, il répond très bien au besoin de
15 réels environnements, là où d'autres outils de gestion de source n'y
16 parviennent pas.</para>
17
18 <sect1>
19 <title>Cet ouvrage est un travail en cours</title>
20
21 <para>Je publie ce livre tout en continuant à l'écrire, dans l'espoir qu'il
22 vous sera utile. J'espère aussi que les lecteurs pourront ainsi y contribuer
23 si ils le souhaitent.</para>
24
25 </sect1>
26 <sect1>
27 <title>À propros des exemples de ce livre</title>
28
29 <para>Ce livre a une approche particulière des exemples d'exécution. Ils sont
30 toujours <quote>dynamiques</quote>&emdash;chacun est le résultat d'un script shell qui
31 exécute les commandes Mercurial que vous voyez. Chaque fois qu'une
32 image du livre est construite à partir des sources, tous les scripts d'exemple
33 sont exécutés automatiquement, et les résultats comparés à ceux attendus.</para>
34
35 <para>Cette approche a l'avantage de garantir que les exemples sont toujours
36 justes ; ils montrent <emphasis>exactement</emphasis> le comportement de la version de
37 Mercurial spécifiée dans la couverture de ce livre. Si je mets à jour cette
38 version, et que les commandes changent, la génération du livre échouera.</para>
39
40 <para>Il y a un petit désavantage à cette approche, les dates et les
41 durées que vous verrez dans ces exemples ont tendances à être
42 <quote>réduits</quote> de manière très différente d'une exécution manuelle. Un être humain
43 ne peut exécuter qu'une commande toutes les secondes, alors que mes scripts
44 automatisés en exécutent plusieurs en une seule seconde.</para>
45
46 <para>Ainsi, en une seule seconde, plusieurs <quote>commits</quote> peuvent avoir lieu
47 au sein d'un exemple. Vous le constatez, entre autres, dans les
48 exemples sur <literal role="hg-ext">bisect</literal>, dans la section <xref linkend="sec:undo:bisect"/>.</para>
49
50 <para>En conséquence, quand vous lisez les exemples, n'accordez pas trop
51 d'importance aux dates et aux durées d'exécution des commandes. Mais
52 <emphasis>soyez sûr</emphasis> que le comportement que vous voyez est cohérent et
53 reproductible.
54 </para>
55
56 </sect1>
57 <sect1>
58 <title>Colophon&emdash;Cet ouvrage est libre</title>
59
60 <para>Ce livre est publié sous la licence <quote>Open Publication License</quote>
61 \footnote{Pour plus de renseignements :
62 <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>{Open Publication License} },
63 et est construit uniquement à l'aide de logiciels libres. Il est mis
64 en forme avec \LaTex{}; et les illustrations sont réalisées avec
65 <ulink url="http://www.inkscape.org/">Inkscape</ulink>.
66 </para>
67
68 <para>L'ensemble des fichiers sources de cet ouvrage est publié dans un
69 dépot mercurial <ulink url="http://hg.serpentine.com/mercurial/book">http://hg.serpentine.com/mercurial/book</ulink>.
70 </para>
71
72 </sect1>
73
74 <!--
75 local variables:
76 sgml-parent-document: ("00book.xml" "book" "chapter")
77 end:
78 -->