Getting Started with Wush.Net and TortoiseSVN

TortoiseSVN is an easy to use SCM / source control software for Microsoft Windows. It is implemented as a Windows shell extension, which makes it integrate seamlessly into the Windows explorer. Since it's not an integration for a specific IDE you can use it with whatever development tools you like.
1. Download the TortoiseSVN client installer from http://tortoisesvn.net/downloads


2. Create a directory to hold your workspaces and create a sub-directory for your working copy within it. In this example, we will be accessing a project named "salamander" and so have created a directory named accordingly.


3. Right-click on the directory you have created to access the context menu. If Subversion is installed correctly, you should see a Checkout option. Click on this option.


4. Next you will see a screen that asks for the URL of your repository. Fill it in as "http://wush.net/svn/" followed by your project name. Our account name is "salamander", so we entered "https://wush.net/svn/salamander".


5. If this is your first time accessing our servers, you will be asked to verify the our SSL signature. Confirm the fingerprint to the one below and click "Accept Permanently".


6. Enter the username and password that you chose when signing up for your account. You may click "save authentication" if you do not wish to be prompted for your password during subsequent actions.


7. A successful checkout will list the files that were downloaded to your computer. This is your working copy and you can make changes to the files here. When made, you can commit them back to update the repository. If you are just starting out, you probably will not have any files.


8. To add a file to your repository, first simply copy it into your working copy directory. In this example, we created the text file named "New Text Document.txt".


9. Now, right click on the file. Choose the TortoiseSVN context menu then select Add. This will queue the file to be added to your repository on your next commit.


10. TortoiseSVN will not disply a confirmation of all files added. If you had added a directory, it would recursively list all the actual files that would be added.


10. TortoiseSVN will let you know if there were any problems on this screen. Your files are not actually a part of your repository yet. They will only be uploaded when you do a commit.


12. Once you have made changes by adding or modifying a file in your repository, TortoiseSVN will show you the files that have been changed. In this example, the file "abiltsms" has been changed as indicated by the red exclamation point and "New Text Document" has been added as indicated by the blue plus sign. You may need to refresh your display for the icons to show up properly, but do not worry about it if they do not appear.


13. To commit your changes, go back to the working copy directory and right click on it again. This time instead of Checkout you should see Update and Commit options. Click on commit.


14. Enter a log message describing the changes you made. This will help you in the future if you are looking for a specific revision where a change was made. The more detailed and consistent your messages, the better.


15. Once you click OK, a successful commit will look like this screen. Your repository is now one revision higher and your changes have been saved. If there were any errors, you will be notified here. This step can take a while if you are uploading large files.