Pr�sentation de 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.

A noter que contrairement � CVS/Subversion, on cr�e g�n�ralement un entrep�t par

projet � g�rer.

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. 

Principales commandes

`````````````````````

* Cr�er un entrep�t local ::

    hg clone ssh://orion//home/src/prive/rep

* Voir le contenu de l'entrep�t local (outil graphique en Tk) ::

    hg view

* Ajouter un sous-r�pertoire ou un fichier dans le r�pertoire courant ::

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

    hg update [identifiant-revision]

    hg up [identifiant-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) ::

    hg pull ssh://orion//home/src/prive/rep

    hg pull -u ssh://orion//home/src/prive/rep # �quivalent � pull + update

* Voir quelles sont les t�tes de branches de l'entrep�t local si un `pull` a

  tir� une nouvelle branche ::

    hg heads

* Verser le r�pertoire de travail dans l'entrep�t local (et cr�er une nouvelle

  r�vision) ::

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

    hg merge identifiant-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) ::

    hg push ssh://orion//home/src/prive/rep

* Voir quelle sont les r�visions locales non pr�sentes dans un autre entrep�t ::

    hg outgoing ssh://orion//home/src/prive/rep

* Voir quelle sont les r�visions d'un autre entrep�t non pr�sentes localement ::

    hg incoming ssh://orion//home/src/prive/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 ::

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

    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`

* penser � faire un `hg push` lorsque votre entrep�t contient une version

  relativement stable de vos modifications

* si un `hg pull -u` a cr�� une nouvelle t�te de branche :

  1. identifier l'identifiant de celle-ci avec `hg head`

  2. fusionner avec `hg merge`

  3. `hg ci`

  4. `hg push`

.. _Mercurial: http://www.selenic.com/mercurial/