User Tools

Site Tools


HOWTO use Subversion

GAMS is using Subversion (SVN) as its version control system for development and work with fellows.

In order to help our partners to get started right away, we recommend either to use the SVN command line tools or the Windows GUI TortoiseSVN for adding and editing files under version control.


If you prefer using a GUI, we recommend using the Windows shell extension TortoiseSVN:

TortoiseSVN is an extension to the Windows Explorer that provides you simple and easy right mouse click access to SVN commands. One of the nicest features of TortoiseSVN is the overlay of icons to tell you at glance which files are under version control and what their status is after installing TortoiseSVN you are ready to start:

  • Open Windows Explorer
  • Create a new folder
  • Right click new folder and select 'SVN Checkout'
  • Enter the url to your repository
  • Select either 'HEAD revision' or a certain 'Revision'
  • Click 'OK'

TortoiseSVN will now make a local copy of the repository (more precisely, everything below the url you provided) under the newly created folder.

If you are editing an existing file you will recognize that icon of the file and the folders above changed meaning that the local file is changed. The files will be marked by a red '!' icon. If you want to add new files(s) or folders, you would just create them in an usual manner and add them to the list of version controlled files by a right click, select 'TortoiseSVN' and select 'Add'. A pop up window will appear guiding you through the adding process. The newly added file(s) themselves will have blue '+' icon. Once you are ready to upload your changes and/or new files to the repository, right click the file(s) or folder and select 'SVN Commit'. Again a window will appear which will remind you to add a meaningful message about your changes.

When there are multiple users on a repository (which is of course the whole purpose of SVN), you may want to update your working copy before starting to work, to see if there were any changes committed in the meantime. Always sticking to this rule will help you avoiding a lot of conflicts. Therefore, again right click your folder and select 'SVN Update'. This will download changed or added files if there were any.

Of course the above is a very very short introduction and covers only a small fraction of what SVN is able to do. For more information you may want to check the TortoiseSVN FAQ.

SVN Command Line Tools

For help on the SVN command line tools have a look at:

Also, type 'svn help' which lists all svn command line commands and/or 'svn help “commandname”' for very useful detailed help.

Also, just search for 'svn cheat sheet'. This will give helpful summaries of the commonly used SVN commands.

interfaces/using_tortoisesvn.txt · Last modified: 2011/10/05 07:41 by support