TortoiseSVN is a Subversion client for Windows. It allows you to contribute to the development of an application in a Subversion software repository using your Windows computer. To later compile a program developed with TortoiseSVN on a Calcul Québec server you will have to copy your code. The best way to do this is probably by means of the command svn, installed on most of our servers.
To install TortoiseSVN, you simply need to download the installation file "TortoirseSVN-version.msi" and follow the default installation steps. You will need to restart your computer once the installation is complete.
The basic functionality ("checkout", "update", "commit" etc.) of TortoiseSVN is simple. As TortoiseSVN is integrated into Windows Explorer, it's unnecessary to start another application. The TortoiseSVN menu is accessible via Windows Explorer's contextual menu, clicking on the right mouse button.
Importing a New Project into Subversion
You just need to right click on the directory that you want to import and select the menu item TortoiseSVN -> Import. The following window will appear:
URL of Repository is the address of the repository, that is the equivalent of the environment variable CVSROOT in CVS. Users accustomed to CVS will notice that the syntax differs slightly.
Checking Out an Existing Project
You just need to right click on the folder that you want to check out and select the menu item SVN Checkout, the following window will appear:
Composing the Depository URL
The syntax for the repository address (URL) has the form protocol://username@server/repository where
- Subversion supports several protocols. The Université de Sherbrooke site offers access to a Subversion repository which functions only with SSH, thus "svn+ssh".
- Your username on the Subversion server.
- Address of the Subversion server, at the Université de Sherbrooke for example cvs.ccs.usherbrooke.ca.
- The location of your repository on the server. At the Université de Sherbrooke this is /cvs/project. To extract just a given directory, you simply need to add its name. An example, /cvs/project/module/directory.
Small icons will appear on files and directories that come from a Subversion repository
Depending on the file or directory selected, the TortoiseSVN menu will adapt. For example, the diff option, which compares a local file to the repository version, only appears if the local file has been modified.
The menu option SVN Update allows you to update your local copy while SVN Commit sends your modifications to the server.
A major difference between Subversion and CVS is that with Subversion you can move and rename directories. You just need to select the menu option TortoiseSVN->Relocate to move a directory:
Here, the menu option TortoiseSVN->Rename allows you to rename a file or directory,
Obviously, you will be asked for your password at each operation, which can become annoying. It's better to use "PuTTY Agent" which allows you to use an SSH key pair to handle the authentication process. This way, you won't have to type your password but you will need to type a single time the password which manages access to your private key. Click here to learn how to do this.