Subversion Repository: HOWTO

HELLO SUBVERSION in Windows

http://tortoisesvn.tigris.org/

This is a minimal but totally functional how to checkout from, and commit to, gpl.openqm in Windows using the Tortoise Windows Explorer shell extension. Think of Tortoise as a folder sync tool which pops up reconciliation screens where conflicts occur between people's edits.

The interesting bits of source code management jump out at you later when two people work on the same file at the same time.

• You commit a file which has also committed by someone else AFTER you checked it out
• You update your depo from repo and someone has committed changes to a file that you have already locally changed.

In these cases you get presented with opportunity to compare and reconcile the two edits in a neat side by side window.

Other tools

Visual Studio - http://ankhsvn.open.collab.net/

Eclipse - http://subclipse.tigris.org/

Netbeans supports it natively now too. <Diccon> Bean a life saver. (Can we have a few hints, Diccon?)

Installation

http://tortoisesvn.net/downloads

Might need a reboot

Checking Out

Right click on your desktop and choose SVN CHECKOUT

Fill in the details

URL? https://gpl.openqm.com/svn/qmvdb

Checkout Folder? D:\Documents and settings\steve\Desktop\TESTIT

Click OK

Do you want to create the directory? Yes

Do you want to accept the unsigned certificate? Yes

Wait while it downloads the whole repository

Finished: OK

After you click on the folder or refresh desktop with F5, the new folder TESTIT should have a big green tick over it indicating all synced with the repo

Subversion puts a hidden folder called .svn in any folder it is managing

Acquiring rights to commit

To commit you must have a username and password which is given by an admin with root perms on gpl.openqm.com with the following command where xxxxxxx is the username

htpasswd /etc/subversion/passwd xxxxxxxxx

Committing

1. Open the folder TESTIT
2. Create a file called testing.txt anywhere in the folder structure
3. Close the folder and notice that it has a big red ! on it showing that something is commitable
4. Right click on the TESTIT folder (or indeed any subfolder)
5. Choose SVN Commit
6. It shows a long list of files that it thinks could be committed - in your case just the testing.txt file - you have to check all files that you want uploaded or check Select All
7. It helps to add a message explaining why you are committing
8. Click OK
9. Enter your committers username and password
10. Screen showing upload progress
11. Click OK when finished and note that the red ! has changed back into a green tick