Game Developers Club
Student Organization • 319 people
Files / Tutorials

Short and Dirty SVN Tutorial

To get started in SVN:
1) Get it

1a) Windows users, go to http://tortoisesvn.net/downloads.html and get the version of TortoiseSVN that matches your operating system.  Trust me, if you try to install the wrong one it will fail.

1b) Mac users: I can't help you, the last mac I used was an Apple II. 
(ADDED 10/3)
The following is a link to a tutorial http://www.rubyrobot.org/tutorial/subversion-with-mac-os-x that should take care of it. The Download and Installing Subversion section seems really straight forward. 

An alternative to this is to download XCODE https://developer.apple.com/xcode/ . Install the Command Line Commands and be done with it (at least that's what I remember of it...)

1c) Linux users: use sudo apt-get install subversion.  Most distros don't include it defaultly, so you probably don't have it unless you've used it before.


2) Check out your project!

2a) Go to code.google.com and log in with the account you gave your project leader.  At the top bar in the Favorites menu there should be the project name.  Click on the project name.

2b) Click on the Source tab.  This will give you a set of instructions to checkout the project.  Linux and Mac users just follow the top bit and you are golden.

2c) Windows users are a bit more complicated.  To checkout a project with TortoiseSVN, right click in a file structure (I

recommend somewhere you can get to easily) and select SVN Checkout.  The URL is https://<project name>.googlecode.com/svn/trunk/ and the other options stay the same.  Keep the Google code page handy, because the first time you commit you have to enter the email you used and the automated password Google makes for you.

3) Adding stuff!
!!SUBVERSION WILL NOT AUTOMATICALLY ADD NEW FILES!!
You have to add the files in the TortoiseSVN right-click menu if you are Windows, and use the command svn add <file or directory> if you are on Mac or Linux.

4) Committing your changes!
!!Another !!Flaming!! Warning!!
!!SVN WILL OVERWRITE EXISTING DATA IN FILES WHEN YOU COMMIT!! (actually it tries to merge files, but that isn't the most effective solution and tends to mess up a lot)
Make sure that you update the project and make sure it still works before you commit.
Also make sure that you say what you changed, so other people know what's happening.  TortoiseSVN has a nifty text box in the commit window you can use.  Linux and Mac need to add -m "message goes here" at the end of the commit.

5) Oh crap, I added the wrong thing!
to remove a file with Tortoise, right click on it and select delete.  To remove a file on mac or linux, use svn delete <file or directory>

6) General references:
Mac/Linux: svn --help will list different options.
Windows: right-click somewhere and TortoiseSVN->Help opens the help dialog.
Of course, also asking someone else is good too if you are confused.