Git Installation and Setup

Written by Aditya Acharya

In keeping with the class's goal to expose you to some new technologies, we have decided that Git, not Subversion, will be the source control mechanism used. One big advantage of Git over Subversion is that it provides each user with a local copy of the repository. So, there will now be 2 repositories to keep in mind as you develop: your local repository and the class repository. As you develop, you can commit and revert freely with your local repository, and have no worries about conflicts. When you're satisfied with what you have done, then you can push your code to the class repository. This prevents unnecessary commits to the class repository just for the sake of having a revision to revert to. For a more in depth discussion of Git, see Wikipedia.

• Go to http://code.google.com/p/git-osx-installer/ and download git-1.6.6-intel-leopard.dmg from the "Featured Downloads" section or the "Downloads" tab.
• Run git-1.6.6-intel-leopard.pkg and follow the instructions for a standard install.

• Go to http://code.google.com/p/msysgit/ and download Git-1.6.5.1-preview20091022.exe from the "Featured Downloads" section or the "Downloads" tab.
• Run the executable. Just keep clicking "Next" until the installation starts and completes. There are some scary-looking messages in bright red, but those options are not selected by default, so as long as you don't change anything you should be fine.
• Go to the desktop and double-click on "Git Bash". This should start a terminal.
• Run this command, substituting in your SUNetID. This command should have quotes:
  • ssh-keygen -C "<SUNetID>@stanford.edu" -t rsa
• Accept the default key location, but save the path to that location somewhere, since you might need the key later in the quarter.

• Start a terminal, and run this command. You may have to enter your password, and just hit "Enter" at every question to accept the default response.
  • sudo apt-get install git-core
• Alternatively, you can use the Synaptic package manager to download the latest git-core package. You might also want to download the gitk and git-gui packages, which allow for graphical browsing of the git repository. The qgit application also allows for this.

• Start a terminal (Mac or Linux) or the Git Bash (Windows).
• Run these commands, substituting in your name and then your SUNetID. The first command should have quotes. The second command should not.
  • git config --global user.name "<Your name here>"
  • git config --global user.email <SUNetID>@stanford.edu

• Start a terminal (Mac or Linux) or the Git Bash (Windows).
• Navigate to the folder where you want to pull the latest version of the class repository to. The repository will be pulled down as a self-contained folder.
• Run this command, all on one line, substituting in your SUNetID.
  • git clone ssh://<SUNetID>@myth.stanford.edu//afs/ir.stanford.edu/class/cs193s/git/repo1
• If you are asked if you are sure whether you want to continue connecting, enter "yes" (no quotes).
• Enter your SUNet password. Once you do this, git will download the latest version of the class's repository as folder named "repo1".