Subversion repository

= What is Subversion, and why? =

is a system, for keeping track of changes to source code.

Subversion allows to:
 * see the history of changes made to source code
 * retrieve any version of any file
 * see the difference between any two versions of code
 * see the changes you made locally, compared to the version you originally checked out
 * create patches of any changes
 * update your local copy to the latest version, or any specific version, "merging" changes automatically
 * Build and test the code constantly as it evolves, allowing to find new bugs earlier

This is very useful for those working with source code - looking for bugs, making changes or simply compiling the latest version because of features or bugfixes.

Advantages
This can result in quicker and easier turnaround for features and bugfixes:
 * Changes can be made available instantly without uploading a full release, and coders can automatically merge them into their "working copies".
 * Coders can be looking at the most current version of the code, testing it, looking for bugs, adding features. When someone submits a patch, it can be against the latest version, which makes it easier to integrate.
 * Source control provides a backup of the code at each point where it was checked in. This leads to less loss in the case of unexpected hard drive failure or similar circumstances. It also makes it much easier to go back to the last known working version if that becomes necessary.

= Compiled SVN builds = Compiled SVN builds for Windows systems are available on DRD Team:
 * http://svn.drdteam.org/slade/

= Repository URL = The SLADE subversion repository is generously hosted by Manc at http://mancubus.net/svn/hosted/slade. Additionally, if you are interested, you may find the SLumpEd SVN in nearly the same location at http://mancubus.net/svn/hosted/slumped.

Subversion checkout path - If you want just the latest development version of SLADE, and aren't interested in grabbing the old branches of SLADE 1 and SLADE 2, you should use your subversion client to check out http://mancubus.net/svn/hosted/slade/trunk/.

Browse the repo - You can browse the entire slade repository and view detailed information (like revision histories, dates, etc.) by pointing your web browser here:

http://mancubus.net/svn/slade/

= Getting the sources =

Using Subversion's own utilities
Download Subversion tools at http://subversion.apache.org/packages.html. Add the directory where you installed them to PATH.

To check out Slade sources, open a command prompt window and: cd c:\path\to\where\you\want\sources svn checkout http://mancubus.net/svn/hosted/slade/trunk/

To update previously checked-out sources: cd c:\same\path\as\before svn up

Using TortoiseSVN (Windows Explorer plug-in)
Download TortoiseSVN from TortoiseSVN.net.

To check out SLADE sources,
 * navigate an Explorer window to the folder of your choice.
 * find "checkout" in context menus
 * enter repository URL: either http://mancubus.net/svn/hosted/slade (full project) or http://mancubus.net/svn/hosted/slade/trunk/ (just the current trunk)

There is also a Firefox plugin for TortoiseSVN at Pumacode.org. You need to install TortoiseSVN first for it to work, of course.