Differences

This shows you the differences between two versions of the page.

--- lirec:version_control_guide [2009-02-04 13:51] – 81.188.78.24
+++ lirec:version_control_guide [2009-02-04 14:54] – davegriffiths
@@ Line 7: / Line 7: @@
 =====Usage pattern=====
+Before we get into using svn, there are some basic usage patterns which are common to all revision control systems. You get the most out of version control if you make it part of your daily programming routine.
+The general idea is that code lives on a remote server, and you keep a local copy of the source on your hard drive. You edit files as normal then 'commit' changes to the remote server. You also need to periodically update your code to get changes other people have made.
+The smaller the changes that you check in are, the less hassle you will cause for yourself and other people.
+=====SVN Basics=====
+I've set up the lirec svn repository with a dummy project called sandbox that you can play with and break to your heart's content. This guide is written for the commandline version of svn, if you use Windows and prefer buttons to press, read through this document anyway and then have a look at [[http://tortoisesvn.tigris.org/|Tortoise SVN]]. I'll update this with a guide for using that as soon as I get myself a Windows install.
+Firstly svn likes to know what editor you like to use so it can launch it to ask you to input comments for your code commits. Put this in your .bashrc:
+<code>export EDITOR=vi</code>
+Or the equivalent in windows [TODO].
+====Getting the code====
+Firstly go to a directory where you want to keep your code and run:
+<code>svn checkout --username your-lirec-username http://svn.lirec.eu/</code>
+Obviously replacing "your-lirec-username". The username is required to link the changes you make to you.
+====Make some changes====
+cd into 'sandbox' and edit the impressive application you'll find there. When you've saved run:
+<code>svn commit</code>
+This will pop up the editor you specified earlier. Add a nice informative message (you should always add a message saying why you've made the change). Save the file, and close the editor. If all is well, your change is now on the svn server.
+====Adding files====
+<code>svn add filename</code>
+Will add individual files, or recursively add files in a directory.
+====Directories, moving, removing====
+<code>svn mkdir mydirectory</code>
+Will make a new empty directory registered with svn.
+<code>svn mv /path/to/file /another/path/to/file</code>
+Will move or rename a file.
+====Updating====
+<code>svn update</code>