C++ Reference Material for CSCI 2341 and CSCI 2342
Subversion How-To

1. This discussion assumes you have a personal account on the cs machine and that you have installed TortoiseSVN on your Windows machine.
2. To check the existence (and version, if it exists) of Subversion on the cs machine, give the following commands at the command line in your cs account:

     svn --version
     svnadmin --version
   

3. To create a Subversion "repository" under your account on the cs machine:

   svnadmin create /account_path/account/svn-repos
   

4. Now, in your Windows account create a VS project directory, say MyProject, containing just "minimal" content (basic VS config files, utilities package files, and source code files).
5. Then close down VS to avoid the problem of TortoiseSVN not being able to upload one or more of your files because they are "in use".
6. Now, from your Windows account, right click on the MyProject folder and choose TortoiseSVN | Import ...
7. In the window that opens up enter the following information for your account and the project you are sending to the Subversion repository into the box labeled URL of repository:

   svn+ssh://account@cs.smu.ca/account_path/account/svn-repos/project-name/trunk
   

8. If you like, enter a relevant message into the message box as well.
9. Now click OK. After a short delay you should get a window asking for the password for your account. Enter it and click OK again (you may have to do this up to 3 times, for reasons no one seems to understand). You should then see some activity indicating that the contents of your chosen directory have been uploaded.
10. To confirm that everything went OK, and also to get a "working copy" of what you just uploaded, create a new folder called, say, MyProjectSMU. Then right-click on this folder and choose Svn Checkout ..., enter your password, and you should get a report saying you are at revision 1 (you again may have to repeat this a couple of times). At this point you can delete the original MyProject folder on your Windows machine and work away in the MyProjectSMU folder, making changes that will later be uploaded to the repository as well.
11. After working for a while, you will want to "commit" the changes you've made to the repository. To do this, again right-click on the MyProjectSMU folder and this time choose SVN Commit ..., after which you will be presented with a window showing the files you have changed with a checked box next to them. If you just want to commit those changes to the repository, click OK, enter your password when prompted, and click OK (possible repetition required here again). If you created some new files in this working directory, you will also see those listed, with an unchecked box next to each one. If you want to commit one or more of those files to the repository, simply check the appropriate box(es) before completing the commit action.
12. At this point you can go home (or anywhere else in the world) and as long as you have TortoiseSVN installed on a Windows machine, you can perform a "checkout" of the project from the repository. To do this, first create a directory where you want to work, say MyProjectHome, then right-click on this directory, choose SVN Checkout ..., enter the required information (from the above discussion it should be clear what this information should be) and click OK. Your project files should then be downloaded and placed in the directory you have chosen. After working on the files for a while, you should not forget to commit your latest changes back up to the repository.
13. And so on ...