Using Mercurial

Configure Mercurial

Mercurial is configured through several rc files. You can override the
system-wide settings on a per-user or per-repository basis by changing either
~/.hgrc or <repository>/.hg/hgrc. See man hgrc for details.

You must set your username when working with Mercurial repositories. To do
that, add two lines to ~/.hgrc (or optionally <repository>/.hg/hgrc, if you
want to use a different username for other Mercurial repositories):

[ui]
username = First Last <email@address.tld>

Other useful options that can be set in the [ui] section of an hgrc are the
merge tool and to make Mercurial verbose or not:

Git diffs can be useful too, and making hg log -v the default behavior for hg log can be helpful:

[diff]
git = True
[defaults]
log = -v

Clone the Repository and Select a Branch

To start working with Pidgin from Mercurial, you’ll probably want to clone our
main repository:

hg clone https://bitbucket.org/pidgin/main/ pidgin

This will give you a pidgin directory with the 3.0.0 development code by
default. If you want to develop against Pidgin 3.0.0, you’re all set!

Naturally, Pidgin has a number of branches within its repository, and these
branches handle various projects including our maintenance of Pidgin 2.x.y. We
won’t go into all the branches here, as there are a lot of them, but we know
some people would like to work against Pidgin 2.x.y instead of 3.0.0. In order
to do that, clone the repository as above, but then do this: