SVN on Windows
From Wesnoth
Contents |
Getting SVN Access
If you plan to make changes to Wesnoth you will need to get permission from the proper developers, whom you can find on IRC: #Wesnoth-dev. Write permission is not needed for users who just wish to checkout the most recent changes to Wesnoth, or wish to tinker around on their own.
Step 1: Prerequisite applications
You will need to obtain a Windows SVN Client. TortoiseSVN is a nice, open source SVN client available for Windows. If you don't need write access, you can skip ahead to step 3.
An ssh connection is also required to upload your changes. You will need to setup an ssh-rsa key and then use an authentication agent to, well, authenticate yourself. Puttygen and Pageant, respectively, are simple Windows tools that can do this. You can grab them here.
Step 2: setting up an ssh connection
First, log into gna, and choose to register a new ssh public key (from My Account Conf). Next, run Puttygen to create a fresh ssh-rsa key. Copy the part labeled "for copying" and paste it into gna and then submit it. Now save your key somewhere cosy, and run pageant. Double-click the pageant icon that springs up in your taskbar, and then choose "add key" from the many options that you are presented with. Select the key that you just saved from it's snug location, and your ready roll and/or rock! Now pageant will basically "flash your badge" (ssh-rsa key) when gna asks to see your ID. You will need to load that key into pageant any time you want to use TortoiseSVN.
It may take a few hours for it to register with gna (even though you will see that it is successful immidiatly), so wait a bit before attempting step 3.
Step 3: getting your first checkout
Once installed, TortoiseSVN is accessed through the standard Windows explorer right-click context menus. To try it out, create a clean directory, something like WesnothTrunk, and then right-click on it. The first thing to do is to select "TortoiseSVN" and then "repo-browser", which will prompt you for the URL of the repository.
If you skipped step 2, then you should checkout anonymously, using: http://svn.gna.org/svn/wesnoth/trunk
If you went through step 2, then checkout using your gna! username, like so: svn+ssh://username@svn.gna.org/svn/wesnoth/trunk
After that, you can simply right-click on your clean directory and then select "Checkout".