Domogik project uses Mercurial distributed revision control.

Contrary to a distributed revision control like CVS/SVN, for Mercurial, each local copy is a "master repository".

Use Mercurial for Domogik project is pretty simple:

Mercurial Installation

• With Ubuntu/Debian :

  apt-get install mercurial
  

It is necessary after to configure it, for this, you can use configure-hgrc script or read man, as you want:

hg clone http://bitbucket.org/boredzo/configure-hgrc/
cd configure-hgrc
./configure-hgrc.py

Initialize a repository with the project

• Programmer access (with ssh) :

  hg clone ssh://domogik@rennes1.dunnewind.net/domogik
  

• Public access (read only) :

  hg clone http://hg.domogik.dunnewind.net/domogik/
  

Work on local copy

Once your local copy got, you can work on it as you please. When you want keep a follow-up of your advancement, you can commit your work :

hg commit -m "change of XXX"

This carry out a commit in the local repository (then you can do it without any internet connection :)

To add a new file / directory to the repository :

hg add filename

Be careful : Mercurial doesn't manage empty directories

The same, to delete :

hg remove xxxx

Synchronization from / to the centralized copy

Push and pull operations allow to synchronize your work with the centralized copy.

• local -> central :

  hg push
  

• central -> local:

  hg pull