Subversion

Subversion is a very mature SCM system based on CVS, but lacks some of the efficiency and advanced features of Git. On the other hand, it is considerably more accessible since its tools, such as TortoiseSVN are very much more advanced than those available for Git. Thus, Subversion, at least for the time being, is a lot more user-friendly and is recommended for novice users.

Configuring a project for Subversion

  1. In project Settings, enable module Repository.
  2. Select Repository tab in settings.
  3. Set SCM to Subversion.
  4. Set URL to file:///var/scm/svn/projectname.
  5. Leave Login and Password as defaults.
  6. Click Create button.
  7. Select main Settings tab again (A main Repository tab should then appear).
  8. Select main Repository tab and the repository should be seen.

TortoiseSVN

TortoiseSVN is an extension for Windows Explorer which allows intuitive access to SVN repositories. It can be used alongside TortoiseGit if you wish to have access to both types of repository.

  1. Download and install TortoiseSVN client (if you run with x64, you should install both win32 and x64 versions, so that TortoiseSVN can integrate with either type of application).
  2. Please make sure your key-agent (e.g Pageant) is running, and your private key is loaded.
  3. Go to the directory where you'd like to make a working copy of the repository.
  4. Right-click and select SVN Checkout from the menu.
  5. Enter the URL of the trunk or version tag of your repository, which will be of format like: svn+ssh://svn@svn.dev-heaven.net/projectname/trunk or svn+ssh://svn@svn.dev-heaven.net/projectname/tags/REL_0.5.6
    • Never export the root directory of a repository. This will download many complete versions of the project, one for the trunk and one for each tag or branch!
    • This will create a directory called projectname in the current directory by default, but you can checkout with any local folder name.

Updating the checked out files

Right-click on the checked out folder and select SVN Update.

Using the command line

Not recommended except for advanced users. To use, you must have Subversion (this comes with TortoiseSVN) and plink (included with PuTTY) must be installed.

XP

Edit c:\Documents and Settings\user\Application Data\Subversion\config and add:

ssh=c:/Program Files (x86)/PuTTY/plink.exe -i c:/path/to/your/key.ppk

Vista

Edit c:\Users\user\AppData\roaming profile\Subversion\config and add:

ssh=c:/Program Files (x86)/PuTTY/plink.exe -i c:/path/to/your/key.ppk

Advanced use

Knowledge of the advanced features of Subversion and TortoiseSVN, such as would be required by a developer rather than a tester, is beyond the scope of this tutorial.