Short and Dirty SVN tutorial/reference
posted about 13 years ago
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: You probably already have it, so go on ahead. If you don't, I can't help you, the last mac I used was an Apple II.
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.
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: You probably already have it, so go on ahead. If you don't, I can't help you, the last mac I used was an Apple II.
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.
