[SR-Dev] Annotated git configuration file

[Jan Janak]

Hello,

There is a new page in the wiki which contains my version of the configuration
file for git:

 http://sip-router.org/wiki/git/gitconfig

Some of the options were not so easy to figure out, so I decided to share the
config file to make your git learning curve less steep than mine was (and is
:-). The file is well commented.

Save the configuration file in ~/.gitconfig and set your name and email
address to your real name and real email address. After that you get your copy
of the sip-router repository using:

  mkdir my_repo
  cd my_repo
  git init
  git fetch sr

You have pulled the whole history when the last command finished. "sr" is a
shorthand for the sip-router git repository.

As the next step you can check out the master branch, this is where the most
recent source code is (it is an equivalent of the trunk in svn or HEAD in cvs):

  git co -b master sr/master

"co" is an alias for checkout, this alias is defined in the configuration
file.

So now you have your very own copy of the sip-router repository, but that's
not all, you can also pull the whole kamailio repository into it:

  g fetch km

"km" is a shorthand for the git mirror of the kamailio svn repository. This
command will produce a lot of output (don't be scared) and after it finishes
you will have the full history of both projects--sip-router and kamailio--in
your local git repository. You can, for example, check out kamailio svn trunk 
using:

  git co -b kam_trunk km/trunk

And now you have the sources from kamailio trunk in your working directory.

You can, of course do the same for SER from CVS, to get the latest sources of 
ser:

  git fetch cvs

"cvs" is a shorthand for the git import of the ser cvs repository. Now you can
switch to cvs trunk using:

  git co -b cvs_trunk cvs/cvs-head

And now you have the latest ser sources in your working directory.

And the last repository you can fetch from is the opensips git import:

  git fetch os
  git co -b opensips_trunk os/trunk

And you have the latest sources from opensips trunk.

To display all branches from all repositories run:
  
  git branch -a

The most important branches are:

  sr/master     - Latest version of sip-router core
  cvs/cvs-head  - Latest version of ser from cvs
  km/trunk      - Kamailio svn trunk
  km/1.4        - Kamailio branch with release 1.4
  os/trunk      - Opensips svn trunk

 
  Jan.