hgbook

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

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 diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/fr/ch00-preface.xml	Sun Aug 16 04:58:01 2009 +0200
     1.3 @@ -0,0 +1,78 @@
     1.4 +<!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
     1.5 +
     1.6 +<para>\chapter*{Préface}
     1.7 +\addcontentsline{toc}{chapter}{Préface}
     1.8 +\label{chap:preface}</para>
     1.9 +
    1.10 +<para>La gestion de source distribuée est encore un territoire peu exploré
    1.11 +et qui, par conséquent, a grandi très rapidement grâce à la seule
    1.12 +volonté de ses explorateurs.</para>
    1.13 +
    1.14 +<para>Je rédige un livre sur ce sujet car je crois que c'est un sujet
    1.15 +important qui mérite bien un guide du <quote>terrain</quote>. J'ai choisi d'écrire
    1.16 +ce livre sur Mercurial car c'est l'outil le plus simple pour découvrir
    1.17 +ce nouveau monde et qu'en outre, il répond très bien au besoin de
    1.18 +réels environnements, là où d'autres outils de gestion de source n'y
    1.19 +parviennent pas.</para>
    1.20 +
    1.21 +<sect1>
    1.22 +<title>Cet ouvrage est un travail en cours</title>
    1.23 +
    1.24 +<para>Je publie ce livre tout en continuant à l'écrire, dans l'espoir qu'il
    1.25 +vous sera utile. J'espère aussi que les lecteurs pourront ainsi y contribuer
    1.26 +si ils le souhaitent.</para>
    1.27 +
    1.28 +</sect1>
    1.29 +<sect1>
    1.30 +<title>À propros des exemples de ce livre</title>
    1.31 +
    1.32 +<para>Ce livre a une approche particulière des exemples d'exécution. Ils sont
    1.33 +toujours <quote>dynamiques</quote>&emdash;chacun est le résultat d'un script shell qui
    1.34 +exécute les commandes Mercurial que vous voyez. Chaque fois qu'une
    1.35 +image du livre est construite à partir des sources, tous les scripts d'exemple
    1.36 +sont exécutés automatiquement, et les résultats comparés à ceux attendus.</para>
    1.37 +
    1.38 +<para>Cette approche a l'avantage de garantir que les exemples sont toujours
    1.39 +justes ; ils montrent <emphasis>exactement</emphasis> le comportement de la version de
    1.40 +Mercurial spécifiée dans la couverture de ce livre. Si je mets à jour cette
    1.41 +version, et que les commandes changent, la génération du livre échouera.</para>
    1.42 +
    1.43 +<para>Il y a un petit désavantage à cette approche, les dates et les
    1.44 +durées que vous verrez dans ces exemples ont tendances à être
    1.45 +<quote>réduits</quote> de manière très différente d'une exécution manuelle. Un être humain
    1.46 +ne peut exécuter qu'une commande toutes les secondes, alors que mes scripts
    1.47 +automatisés en exécutent plusieurs en une seule seconde.</para>
    1.48 +
    1.49 +<para>Ainsi, en une seule seconde, plusieurs <quote>commits</quote> peuvent avoir lieu
    1.50 +au sein d'un exemple. Vous le constatez, entre autres, dans les
    1.51 +exemples sur <literal role="hg-ext">bisect</literal>, dans la section <xref linkend="sec:undo:bisect"/>.</para>
    1.52 +
    1.53 +<para>En conséquence, quand vous lisez les exemples, n'accordez pas trop
    1.54 +d'importance aux dates et aux durées d'exécution des commandes. Mais
    1.55 +<emphasis>soyez sûr</emphasis> que le comportement que vous voyez est cohérent et
    1.56 +reproductible.
    1.57 +</para>
    1.58 +
    1.59 +</sect1>
    1.60 +<sect1>
    1.61 +<title>Colophon&emdash;Cet ouvrage est libre</title>
    1.62 +
    1.63 +<para>Ce livre est publié sous la licence <quote>Open Publication License</quote>
    1.64 +\footnote{Pour plus de renseignements :
    1.65 +<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>{Open Publication License} },
    1.66 +et est construit uniquement à l'aide de logiciels libres. Il est mis
    1.67 +en forme avec \LaTex{}; et les illustrations sont réalisées avec
    1.68 +<ulink url="http://www.inkscape.org/">Inkscape</ulink>.
    1.69 +</para>
    1.70 +
    1.71 +<para>L'ensemble des fichiers sources de cet ouvrage est publié dans un
    1.72 +dépot mercurial  <ulink url="http://hg.serpentine.com/mercurial/book">http://hg.serpentine.com/mercurial/book</ulink>.
    1.73 +</para>
    1.74 +
    1.75 +</sect1>
    1.76 +
    1.77 +<!--
    1.78 +local variables: 
    1.79 +sgml-parent-document: ("00book.xml" "book" "chapter")
    1.80 +end:
    1.81 +-->
    1.82 \ No newline at end of file