Git (http://git-scm.com/) is a distributed version control system. It keeps a complete repository next to each working copy, thus one can commit or inspect the project history locally.

Warning: Unlike most other version control systems (e.g., Subversion) a commit is not understood as a difference between two revisions but as the content of its revision. In fact, Git stores the commit under the SHA-1 hash of all files in the project – also files that were not changed in this commit. Thus, the same change of one sub-module committed to two Git branches that differ only in another sub-module results in two different SHA-1 hashes and two different commits. It is possible to work around this by cherry-picking but that will lead to extra headache. Better practice is to have only one feature per branch.

1. GitHub account
   • create an account at GitHub
   • watch our project
2. SSH public key pair
   • for connecting to GitHub you need a SSH public keypair
   • you probably already have a keypair (e.g., for your Subversion setup).
   • in Eclipse you can create or manage SSH keypairs
     • Window → Preferences → General → Network Connections → SSH2
     • on Windows I have my SSH home in C:\Users\Rind\AppData\Roaming\ssh and NTFS-encrypted this directory
     • see also http://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration
   • copy/paste the public key to your GitHub profile at https://github.com/account/ssh
3. EGit
   • install “EGit - Git Team Provider”
     • either from the Eclipse Marketplace
     • or from their update site: http://download.eclipse.org/egit/updates/
4. clone the repository to your computer and add it to Eclipse
   1. in Eclipse select File → Import
   2. then Git → Projects from Git
   3. click “Clone” button
      1. Clone
         • URI: git@github.com:ieg-vienna/Prefuse.git
         • you don't need to change anything else!
         • leave user “git” and password “”!
      2. select branches: leave all branches selected
      3. select a directory where Git should store local repositories
         1. this should be outside your Eclipse workspace directory!
         2. I use C:\Users\Rind\git
      4. Local Destination: accept default values
   4. click “Next” button
   5. in the “Wizard for project import” select “Import existing project”

Note: for contribution development EGit will be sufficient – you do NOT need Git for Windows

Note: I wrote this guide for Eclipse IDE for Java Developers Helios SR2, but it should also work for other versions.

Initial Checkout:

git svn clone svn+ssh://svn.isis.tuwien.ac.at/home/HypoVis/repository/Theses/TimeBench

Work with git as you like, include branches and rebasing.

Commit to server:

git svn dcommit

Update from server:

git svn rebase

• Pro Git e-book – i can recommend
• git community book – i didn't read
• git crash course for Subversion users
• User Guide for Eclipse plugin
• GitHub Help