TubeTK/Development/GITConfiguration

From KitwarePublic
< TubeTK‎ | Development
Revision as of 02:36, 6 January 2011 by Aylward (talk | contribs)
Jump to navigationJump to search

Install git

Linux (Ubuntu)

sudo apt-get install git-core

You may also want to install gitk and git gui

sudo apt-get install gitk
sudo apt-get install git-gui

Windows

  • These instructions are a useful guide to using git on Windows.
  • Install msysgit
    • During the installation, make sure you add Windows Explorer integration, selecting both "Add Git Bash Here" and "Add Git GUI Here"
  • Once you've installed msysgit, you can right-click on any folder to open Git GUI (graphical user interface to git) or Git Bash (console interface to git)
  • Selecting "git bash" allows you to enter the git commands listed in these wiki pages

Local Configuration

These steps are a one-time setup per-user per-machine.

The --global option stores the configuration settings in ~/.gitconfig in your home directory so that they apply to all repositories.

We require all commits in TubeTK to record valid author/committer name and email information. Use git config to introduce yourself to Git:

$ git config --global user.name "Your Name"
$ git config --global user.email "you@yourdomain.com"

Note that "Your Name" is your real name (e.g. "John Doe", not "jdoe"). While you're at it, optionally enable color output from Git commands:

$ git config --global color.ui auto

If less displays strange characters and no color, your LESS environment variable may already be set. You can override the less options with:

$ git config --global core.pager "less -FXRS"