[MMO] Using SVN

SVN is a way for us to share our files together, and to keep track of who made what changes, keep backups, and if necessary, roll back to earlier versions of some or all the files (say if someone goes nuts and replaces all the graphics with pics saying "u suk!").

It's real easy to use: uploading and downloading files is just a rightclick away in any explorer window, or "file/save as" window! The alternative was CVS, but that required you to create encrypted keys and blah blah... far too much hassle!

One click, plz!

For windows users: how to install.

It's pretty easy to set up, as a user. Three steps!

1) Download and install TortoiseSVN. http://tortoisesvn.net/downloads (there're two versions there, 32 bit and 64 bit: if you're unsure, go for the first link, the 32-bit .msi).

2) Rightclick on your desktop (or in "my documents", or wherever you want SVN to put the "\thudgame\" and/or "\discworldmmo\" folders for all the project files you'll download), and click "SVN Checkout" in the rightclick menu.

3) In the form that comes up, type into the "URL of repository" field, for thudgame:
https://thudgame.svn.sourceforge.net/svnroot/thudgame
and for the discworld MMO:
https://discworldmmo.svn.sourceforge.net/svnroot/discworldmmo

Leave the other settings at their defaults, click OK, and watch the hourglass. Stuff should eventually display, and you should see no errors.

Ready to roll! There'll maybe be a fair bit to download, if other people have been uploading their work.

4) (Optional 4th step) Make yourself a username and password at www.sourceforge.net and post the username in this thread. One of the admins will add your username to the project, but you'll only need that to add files - you can download stuff without it, so carry on with these instructions, rather than waiting!

For windows users: how to use.

You can do four things, basically:

1) To download the latest files, rightclick whatever you want to update, and click "SVN Update".

2) To add a file in your the SVN folder to the archive: rightclick ->"TortoiseSVN" -> "Add..." -> "OK". You can add whole folders at once this way, by adding the folder itself. Try not to go overboard though: people have to download all this stuff, and maybe over dialup! Only add the important stuff.

3) To upload your changed or added files, rightclick whatever you changed, and click "SVN Commit". It'll likely ask you for a username and a password - if the admin's granted you access, you should be able to log in with your sourceforge username and password. There'll be a red "!" sign on any files you have changed but not uploaded your changes, so you'll be able to spot them easily. If you commit a folder that contains changed files anywhere in it, it'll upload just those files. Which is nice

4) To "lock" a file, so that you can edit it without there being conflicts (REALLY good idea: please do this!), rightclick -> "TortoiseSVN" -> "Get Lock".

Everything else is fluff. Feel free to play with it: you can probably mess stuff up if you try hard enough, but if the worst comes to the worst, just delete the directory and start over. Everything you've committed will still be on the server.

Linux users

No clicky gui for you so far as I know. Installing is probably something like:
yum install svn

Other instructions should be available from the man page.

For Admins

Regular users don't need to know any of this. This is just because I will otherwise forget.

Admins have access to do various managementy things to the system, about which I know very little. Adding and removing users is the most important.

https://sourceforge.net/svn/?group_id=180266 (ThudGame) and
https://sourceforge.net/svn/?group_id=218834 (DiscWorldMMO)
...are where to manage the settings and whatnot. If you are logged in, you'll see a red "Admin" tab with a list of stuff you can play with. Regular users who aren't logged in won't see that tab.

The important link there is "members" - that's where to add people and grant them access to the SVN. But there are plenty of other options to play with too.