Using Git

The Final State Analysis package is tracked using the Git version control system. Git is different than CVS in that it's distributed - each repository is local and can stand by itself. Git makes it easy to pass changes to other repositories. This means you can make commits offline, and without worrying about messing up the central version control system.

Links

• Git For Scientists
• The "central" repo

Downloading Code

To get the code, you can clone from the master repository:

git clone https://github.com/uwcms/FinalStateAnalysis.git

Setting up your own online repo

Go to github.com and set up an account. Then "fork" the master repository. Now you have your own version at:

https://github.com/YOURNAME/FinalStateAnalysis

now get a local copy of your remote version:

git clone https://github.com/YOURNAME/FinalStateAnalysis.git

You can now edit the code, and commit it as often as you like (see below). You can't ever mess anyone else up with conflicts like in CVS so do it often. When you want to share it, "push" it to your github account:

git push origin master

Now you can request that this gets "pulled" into the master repository by going to your github.com site and clicking "Pull Request".

If you've started by cloning someone else's repository (that you don't own), you can upload to yours by setting up (just once) your repo as a "named remote," called mygithub:

git remote add mygithub https://github.com/YOURNAME/FinalStateAnalysis.git

and then push your "master" branch to the new remote "mygithub" by:

git push mygithub master

Committing Code

To commit a file, first add it to the "index" of changes to be commited:

git add file1 [file2]

Once you're ready to commit, run:

git commit -m "my informative commit message"