Mercurial

<<toc></toc>>

Executive summary

Here and here you can find very nice brief quick starting guides for Mercurial.

The normal workflow is:

 * You clone (only the first time; the folder to be created must be empty):

 * You work (change, add, remove, rename, move files).
 * You addremove the files that have been created, moved, deleted, rename:

 * You commit:

 * If someone has pushed in the time between, you pull and merge/update:

and

or

 * You push:

 * You go back to the work step.

Known problems

If you are behind a proxy server

If you're using a proxy server, then you will need to tell Mercurial your proxy settings so that it will use them when attempting any downloads. (See also Maven.)

You will need to create a file in your home directory called **$HOME/.hgrc** with the following text in it:

The number following the colon (8080 in this case) is the port number your proxy operates on.

If the checkout still hangs, then it is possible you are using an older version of mercurial that didn't correctly support https. As of this writing, version 1.7.3 worked fine.