At the minimum you should configure your username or mercurial will most likely give you an error when trying to commit. Do this by editing
~/.hgrc and adding the following:
username = John Smith
To use the graphical browser hgk aka. hg view, add the following to
~/.hgrc (see forum thread):
You will need to installbefore running hg view to avoid the rather cryptic error message:
/usr/bin/env: wish: No such file or directory
To remove Mercurial warnings of unverified certificate fingerprints, add the following to
~/.hgrc (see Mercurial wiki):
cacerts = /etc/ssl/certs/ca-certificates.crt
If you are going to be working with large repositories (e.g.
This will show progress bars on longer operations after 3 seconds. If you would like the progress bar to show sooner, you can append the following to your configuration file:
delay = 1.5
All mercurial commands are initiated with the hg prefix. To see a list of some of the common commands, run
$ hg help
You can either work with a pre-existing repository (collection of code or files), or create your own to share.
To work with a pre-existing repository, you must clone it to a directory of your choice:
$ mkdir mercurial
$ cd mercurial
$ hg clone http://hg.serpentine.com/tutorial/
To create you own, change to the directory you wish to share and initiate a mercurial project
$ cd myfiles
$ hg init myfiles
If you intend on creating a repo of all your
~/. files, you simply initiate the project in your home folder:
$ hg init
It is then just a case of adding the specific files you wish to track:
$ hg add
You can then create a
~/.hgignore to ensure that only the files you wish to include in the repository are tracked by mercurial.
.hgignorefile, you can easily exclude groups of files from your repository.