We are using Mercurial to manage our source code for this project. Many of us are new to it, so here is a overview of how to get a copy of the code and contribute your changes. Please add your expertise.

Install Mercurial

Ubuntu:

sudo apt-get install mercurial

Mac & Windows:

http://mercurial.selenic.com/wiki/Download?action=show&redirect=BinaryPackages

all commands start with hg (chemical symbol for mercury)

Get a copy of the code

hg clone https://urbanedibles.googlecode.com/hg/ urbanedibles

Edit settings for convenience

cd urbanedibles
vi .hg/hgrc

add this to the bottom of the hgrc file:

[ui]
username = Your Name <email@domain.com>

your [paths] section should look like this if you don't want to enter your password all the time:

[paths]
default = https://urbanedibles.googlecode.com/hg/
default-push = https://USERNAME:PASSWORD@urbanedibles.googlecode.com/hg/

username is your google code username. If it's a gmail account, use the part before @gmail.com. Otherwise replace any @ symbols in your user name with %40

password is your google code password (not gmail password) which can be found here

Basic workflow

hg pull - grab remote changes

hg update - apply changes to your local files

edit code, add files, make directories, etc.

hg add new_file_name.py - add a new file

hg commit - commit all changes, enter a summary of what you did

hg push - send your changes to the remote repository on Google Code

hg parents - get info on the currently checked out revision

Merging

http://wiki.alliedmods.net/Mercurial_Tutorial#Merging_and_You

Making or Changing Branches

hg branch - shows current branch

hg branch new_branch_name - create and start using new branch

hg update -C branch_name_to_switch_to - make changes in a different branch (e.g. sandbox)

Help

http://wiki.alliedmods.net/Mercurial_Tutorial

IRC: #urbanedibles on freenode.net