How to get TortoiseSVN working with our project

From Shadowrun: Awakened

TortoiseSVN is very easy to setup and use.

Contents 1 Install 2 Looking at the project 3 Pulling something down 4 Syncing to the project 5 Committing Changes

Install

TSVN is easy to download and install. It's just a standard Microsoft installer package.

1. Go to: http://tortoisesvn.net/downloads
2. Download 32 or 64 bit version as appropriate
3. Run installer and restart

Looking at the project

You now have TSVN installed. This gives you a set of extra options in your context-menu (right-click-menu) while using windows explorer. You can use these to pull down the project.

1. Right-click on some whitespace in any window, bringing up the context menu (this includes the desktop!)
2. You will see a "TortoiseSVN" option in the menu, hover over it
3. The expanded menu should have a "Repo-Browser" option, click it
4. In the ensuing dialog, enter "https://shadowrunmmo.svn.sourceforge.net/svnroot/shadowrunmmo" for the URL
5. The main window should refresh with the contents of our repository

You now have read access to our project!

Pulling something down

Now that you can see the repository, you can download things from it.

1. In the main window of the "repo-browser", select a directory from our project
2. Right-click on it
3. In the context menu, choose "check-out" for that item, a new dialog will appear
4. For the option "checkout directory" fill-in or browse to your preferred location (It is best to use "C:\SRA" as your location as part of the client application is dependent on that path)
5. Hit OK

The contents of the selected directory will download to your selected location. You will see it marked with a large green check sign, indicating it is being tracked by TSVN.

The "Development" branch of the code is the actively edited branch used by developers.

The "Alpha" branch of code is a 'snapshot' of the development branch that is used by Quality Assurance.

Syncing to the project

After you have your files for a while, they may no longer be the head revision. To sync them, just right-click the file/directory and select "update" from the menu.

Committing Changes

After you have made changes to your files, you may want to send the changes back to the SVN. To do so, simply right-click the file/directory and choose "commit".

NOW WAIT! A dialog will come up listing the sub-directories and files contained within. Please take care to only select files your have modified. DO NOT COMMIT ANYTHING MORE THAN CODE FILES THAT YOU HAVE CHANGED!!! This is especially true of any DLL or EXE you have built, since TSVN will not realize the difference and they will inflate the size of the project in the SVN. Any DLL, EXE, build, or debug information that can be created by just hitting "Build" should NOT be entered in the repository.

NOTE: This action requires you to have commit rights to the SVN repository through Sourceforge. If you do not have these rights, but are a member, please send changes to the appropriate group's lead developer. If you are not in the project, please send your contribution to Cris our QA Manager email.