GIT Quick Start Guide

The document tries to collect useful information to make life easier working with the GIT repository of SIP Router Project.

• git://git.sip-router.org/sip-router - (read only)
• http://git.sip-router.org/sip-router - (read only, slower, git://... recommended)
• ssh://git.sip-router.org/sip-router - (read/write, developer account needed on git.sip-router.org)

• http://git.sip-router.org/cgi-bin/gitweb.cgi

• Recommended git version: >= 1.5.6.1
• First of all, set your name and email address:

git config --global user.name 'your_name'
git config --global user.email 'your email address'

Some other recommended git config setting:

• include summaries of merged commits in commit merge messages (a MUST)

git config --global merge.log true
git config --global merge.summary true  # same as above, for older git versions

• behave as if –track is added to every git-pull

git config --global branch.autosetupmerge always

• by default use –no-ff when merging into master (this means that a merge commit message will be generated for all merges; without it fast-forward merges will not generate a merge message). Note: –no-ff will generate merge logs even when updating master from origin (git pull origin master), which is not what you want. You should either use "--no-ff" by default like described below, but then make sure to add "–ff" every time you update your local master version (git pull –ff origin master), or you don't use it, but then always remember to add "--no-ff" when merging some other branch into master (e.g.: git merge –no-ff origin/foo).

git config branch.master.mergeoptions  "--no-ff"

Please see GIT merge into master howto