How to set up the Mercurial Source Control Management system so you can participate in the development of MCL.

Installation

• Download Mercurial and follow the instructions to install it on your system.
• Check out the tools to use with Mercurial, including GUI clients.
• Browse the Mercurial wiki for more information.

Getting Started

You may want to start by cloning the current mcl code repository into a new mcl directory:

$ hg clone https://mcl.googlecode.com/hg/ mcl

Change the current directory to the newly created one:

$ cd mcl

Make a modification in the local mcl repository. Optionally use hg diff to display the changes. Next, commit the change:

$ hg commit --message "Describe the change" --user "Your name <user@domain.com>" 

Next, push the changes to the main repository:

$ hg push https://username:gcpasswd@mcl.googlecode.com/hg/

Substitute the google username and gcpasswd with your own. Note that an eventual @ in the googlecode username should be encoded as %40 (single %) to distinguish it from the separator between the username and the password.

Next time you want to make a change, you can optionally pull the recent changes instead of cloning the main repository:

$ hg pull https://mcl.googlecode.com/hg/

See the QuickStart for a brief practical introduction to other Mercurial functionality.

Default Paths

For convenience you may add default paths for the MCL project to the hgrc file (.hg/hgrcin your Mercurial repository directory):

[paths]
default = https://mcl.googlecode.com/hg
default-push = https://username:gcpasswd@mcl.googlecode.com/hg/

Substitute the username and gcpasswd with your own. Keep in mind that the gcpassword is not the same as your login password.

Note that an eventual @ in the googlecode username should be encoded as %%40 (double %) to distinguish it from the separator between the username and the password.

Setting a Username

To get a meaningful name associated with your changes, add your preferred username to the hgrc file (~/hrgc or .hg/hgrc in your Mercurial repository directory):

[ui]
username = First Last <username@gmail.com>