How To Install and Use TortoiseSVN in Windows

1. Open a web browser and direct yourself to http://tortoisesvn.net
2. Click on Download
   
3. Download the latest version of TortoiseSVN (~18MB)
4. Open and install the executable file
   
5. Restart your system to complete the installation
6. Now that TortoiseSVN is installed, it acts as a shell extension. You don't need to run it as a program; it will be a menu when you right click on a folder
   
7. To initially connect to udarknet's subversion directories and download the current source code, you use the “check out” function. You can do this by right clicking on a folder and clicking “SVN Checkout”
   
   You will then need to enter this information:
   svn+ssh://username@udarknet.com/var/svn/repositoryname
   ex: /sensorplatform or /crimetracker
   Enter your password and you should be fine. The code will all download into the directory you choose.
8. Working with the source.
   As you make changes to the source, you are working with your own personal copy of the files. Nobody else sees those changes until you “commit” those changes to the repository.
   Once you are finished editing the file, the subversion can tell that you've changed the file. When you right click on the modified file, all you need to do is click on “SVN Commit”
   Before changes:
   
   When modified:
   
   Folders reflect that files are changed too:
   
   Click commit:
   
   Commit menu:
   
9. If two people are working on the same file, the Person A who commits first has the current version updated to reflect his changes. Person B would still be working on a version that is not up to date. Person B could choose to use the “update” command to incorporate the current version's changes into his code. He would then finish his changes and commit another version to the repository. If he commits without updating, then any changes will be merged together with the current version. If there are conflicts in the code (portions that both people changed), then the user is manually asked to resolve the issues.
10. To initially commit a project, it is a similar process to a regular commit. Just select the folder that you want to put into the repository, and click on “Import”
    
11. If you are editing a file and someone else changes it, and you for some reason want to just remove all of your changes and get the newest version, you can click on “Revert”; that will just download the current revision and delete all of your changes.
    
12. If you have any questions, just ask me. I read a lot of the manual.

Optional: to view our project files, Steve has set up Trac at http://udarknet.com/trac. It allows you to view and track all of the files and versions in a project folder.

Also, the English manual for Tortoise SVN is located here: http://internap.dl.sourceforge.net/sourceforge/tortoisesvn/TortoiseSVN-1.5.6-en.pdf

— surfingcat 2009/01/15 07:29