doc/book/en/D060-mercurial.en.txt
changeset 208 30762142841f
parent 127 ae611743f5c6
child 267 843e0b1bf991
--- a/doc/book/en/D060-mercurial.en.txt	Thu Dec 11 09:44:19 2008 -0800
+++ b/doc/book/en/D060-mercurial.en.txt	Thu Dec 11 10:58:52 2008 -0800
@@ -2,115 +2,113 @@
 
 .. _MercurialPresentation:
 
-Présentation de Mercurial
-=========================
+Introducing Mercurial
+=====================
 
 Introduction
 ````````````
-Mercurial_ gère un ensemble distribué d'entrepôts contenant des arbres de
-révisions (chaque révision indique les changements à effectuer pour obtenir la
-version suivante, et ainsi de suite). Localement, on dispose d'un entrepôt
-contenant un arbre de révisions, et d'un répertoire de travail. Il est possible
-de mettre dans son répertoire de travail, une des versions issue de son entrepôt
-local, de la modifier puis de la verser dans son entrepôt. Il est également
-possible de récuprer dans son entrepôt local des révisions venant d'un autre
-entrepôt, ou d'exporter ses propres révisions depuis son entrepôt local vers un
-autre entrepôt.
+Mercurial_ manages a distributed repository containing revisions
+trees (each revision indicates the changes required to obtain the
+next, and so on). Locally, we have a repository containing revisions
+tree, and a working directory. It is possible
+to put in its working directory, one of the versions of its local repository,
+modify and then push it in its repository. 
+It is also possible to get revisions from another repository or to export
+its own revisions from the local repository to another repository.
 
-A noter que contrairement à CVS/Subversion, on crée généralement un entrepôt par
-projet à gérer.
+
+In contrast to CVS/Subversion, we usually create a repository by
+project to manage.
 
-Lors d'un développement collaboratif, on crée généralement un entrepôt central
-accessible à tout les développeurs du projet. Ces entrepôts centraux servent de
-référence. Selon ses besoins, chacun peut ensuite disposer d'un entrepôt local,
-qu'il faudra penser à synchroniser avec l'entrepôt central de temps à autre. 
+In a collaborative development, we usually create a central repository
+accessible to all developers of the project. These central repository is used
+as a reference. According to its needs, then everyone can have a local repository,
+that you will have to synchronize with the central repository from time to time.
 
 
-Principales commandes
-`````````````````````
-* Créer un entrepôt local ::
+Major commands
+``````````````
+* Create a local repository::
 
-    hg clone ssh://orion//home/src/prive/rep
+     hg clone ssh://orion//home/src/private/rep
 
-* Voir le contenu de l'entrepôt local (outil graphique en Tk) ::
+* See the contents of the local repository (graphical tool in Tk)::
 
-    hg view
+     hgview
 
-* Ajouter un sous-répertoire ou un fichier dans le répertoire courant ::
+* Add a sub-directory or file in the current directory::
 
-    hg add rep
+     hg add rep
 
-* Placer dans son répertoire de travail une révision spécifique (ou la dernière
-  revision) issue de l'entrepôt local ::
+* Move to the working directory a specific revision (or last
+  revision) from the local repository::
 
-    hg update [identifiant-revision]
-    hg up [identifiant-revision]
+     hg update [identifier-revision]
+     hg up [identifier-revision]
 
-* Récupérer dans son entrepôt local, l'arbre de révisions contenu dans un
-  entrepôt distant (cette opération ne modifie pas le répertoire local) ::
+* Get in its local repository, the tree of revisions contained in a
+  remote repository (this does not change the local directory)::
 
-    hg pull ssh://orion//home/src/prive/rep
-    hg pull -u ssh://orion//home/src/prive/rep # équivalent à pull + update
+     hg pull ssh://orion//home/src/private/rep
+     hg pull-u ssh://orion//home/src/private/rep # equivalent to pull + update
 
-* Voir quelles sont les têtes de branches de l'entrepôt local si un `pull` a
-  tiré une nouvelle branche ::
+* See what are the heads of branches of the local repository if a `pull`
+  returned a new branch::
 
-    hg heads
+     hg heads
 
-* Verser le répertoire de travail dans l'entrepôt local (et créer une nouvelle
-  révision) ::
+* Submit the working directory in the local repository (and create a new
+  revision)::
 
-    hg commit
-    hg ci
+     hg commit
+     hg ci
 
-* Fusionner, avec la révision mère du répertoire local, une autre révision issue
-  de l'entrepôt local (la nouvelle révision qui en résultera aura alors deux
-  révisions mères) ::
+* Merge with the mother revision of local directory, another revision from
+  the local respository (the new revision will be then two mothers
+  revisions)::
 
-    hg merge identifiant-revision
+     hg merge identifier-revision
 
-* Exporter dans un entrepôt distant, l'arbre de révisions contenu dans son
-  entrepôt local (cette opération ne modifie pas le répertoire local) ::
+* Export to a remote repository, the tree of revisions in its content
+  local respository (this does not change the local directory)::
 
-    hg push ssh://orion//home/src/prive/rep
+     hg push ssh://orion//home/src/private/rep
 
-* Voir quelle sont les révisions locales non présentes dans un autre entrepôt ::
+* See what local revisions are not in another repository::
 
-    hg outgoing ssh://orion//home/src/prive/rep
+     hg outgoing ssh://orion//home/src/private/rep
 
-* Voir quelle sont les révisions d'un autre entrepôt non présentes localement ::
+* See what are the revisions of a repository not found locally::
 
-    hg incoming ssh://orion//home/src/prive/rep
+     hg incoming ssh://orion//home/src/private/rep
 
-* Voir quelle est la révision issue de l'entrepôt local qui a été sortie dans le
-  répertoire de travail et modifiée ::
+* See what is the revision of the local repository which has been taken out 
+  from the working directory and amended::
 
-    hg parent
+     hg parent
 
-* Voir les différences entre le répertoire de travail et la révision mère de
-  l'entrepôt local, éventuellement permettant de les verser dans l'entrepôt
-  local ::
+* See the differences between the working directory and the mother revision
+  of the local repository, possibly to submit them in the local repository::
 
-    hg diff
-    hg commit-tool
-    hg ct
+     hg diff
+     hg commit-tool
+     hg ct
 
 
-Bonnes pratiques
-````````````````
-* penser à faire un `hg pull -u` régulièrement et particulièrement avant de
-  faire un `hg commit`
+Best Practices
+``````````````
+* Think of making a `hg pull -u` regularly, and particularly before
+   a `hg commit`.
 
-* penser à faire un `hg push` lorsque votre entrepôt contient une version
-  relativement stable de vos modifications
+* Think of a `hg push` when your repository contains a version
+  relatively stable of your changes.
 
-* si un `hg pull -u` a créé une nouvelle tête de branche :
+* If a `hg pull u` created a new branch head:
 
-  1. identifier l'identifiant de celle-ci avec `hg head`
-  2. fusionner avec `hg merge`
-  3. `hg ci`
-  4. `hg push`
+   1. identify its identifier with `hg head`
+   2. merge with `hg merge`
+   3. `hg ci`
+   4. `hg push`
 
-.. _Mercurial: http://www.selenic.com/mercurial/
 
 .. include:: D061-mercurial-forest.en.txt