Using Git

Git small howto

This is a small note for developpers. Bio++ is now using git as its versioning system. There are a lot of tutorials on the web dedicated to the use of git. Here are some very basic features:

Get a copy of the source code from the central repository:

git clone https://github.com/BioPP/bpp-seq.git

To view the status of your local repository, do, when you are in the directory bpp-XXX:

git status

In order to update your local repository from the central one, you need to type:

git pull

To check the modifications done to a file:

git diff myfile

Before committing a file, you need to add this file to the commit-list:

git add myfile

and then commit it:

git commit

Compared to CVS or SVN, commits are local. If you want to send your modifications to the central directory, you of course need an ssh access on the server, and then:

git push

'''BEFORE''' doing this, you will have to tell a bit more about yourself by setting (only once):

git config --global user.name "Your Name Comes Here"
git config --global user.email you@yourdomain.example.com

'''AND''' you will always have to pull before pushing!

Branching

Create a new local branch:

git checkout -b testbranch 

Switch back to master branch:

git checkout master 

List all branches:

git branch 

Push a branch to a remote location:

git push -u origin testbranch 

Delete a branch:

git branch -d testbranch

Delete a branch from a remote location:

git push origin --delete testbranch