= How to Setup a Subversion repository for your Project =

Subversion is a version control system. It allows allows several people to work on their own copy of a project and it maintains backups of older versions. We use it for many things including our [[PapersDotBib|shared bibtex file]]. 

== Setting up a central repository ==

If you are on a non-DICE machine (this should also work on a DICE machine), you can import your files to be stored on subversion with: 

 * {{{svn import YOURDIRNAME svn+ssh://YOURUSERNAME@staff.ssh.inf.ed.ac.uk/group/reason/dream/dream-src/subversion-projects-root/YOURPROJECTNAME}}}

If you are on a DICE machine, you can also do the following: 

 * {{{svn import YOURDIRNAME file:///group/reason/dream/dream-src/subversion-projects-root/YOURPROJECTNAME}}}

The directory where you imported the files does not automatically become directory under subversion. You should rename is and get a local copy of your repository (see below). The old directory can then be deleted when you are confident that you have all your files under subversion.  

== Getting a local copy of the central repository ==

From anywhere, to get a copy of your files in the form of a subversion repository. 

 * {{{svn checkout svn+ssh://YOURUSERNAME@staff.ssh.inf.ed.ac.uk/group/reason/dream/dream-src/subversion-projects-root/YOURPROJECTNAME}}}

From DICE you can avoid typing in a password by using the following: 

 * {{{svn checkout file:///group/reason/dream/dream-src/subversion-projects-root/YOURPROJECTNAME}}}

See '''UsingSubversionHelp''' for information on using the subversion.