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
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