At S1MP3.org we use Subversion and Trac to manage our projects.
Subversion, or SVN for short, is a tool for looking after source code. It records every change made to the code, who made it, and when.
At S1MP3.org we have two SVN repositories:
- svn://svn.s1mp3.org/swan - for code relating directly to the Swan Project.
- svn://svn.s1mp3.org/s1-tools - for the S1 Tools project..
The simplest way to get started with SVN is to use the command line tool, svn. This software is available for pretty much every platform, including Windows, where it is available as a Cygwin package.
To get a copy of the code from a repository do:
svn co <repository>
So, for example, to check out the latest Swan source code, do:
svn co svn://svn.s1mp3.org/swan/trunk
- 'svn://svn.s1mp3.org/' is our SVN server.
- 'swan/' is the repository name
- 'trunk' means the main branch of the code.
After you have checked out the code, you should find a new folder called 'trunk' in the current directory. Inside will be a copy of the HEAD (the latest revision) of our repository. This is called a 'working copy'. SVN manages all of your changes automatically, and can generate patches (diffs), revert changes, or update your working copy. For more informtion about SVN see these pages:
- Control with Subversion - a quite detailed manual for SVN.
- Quick Reference - Command line reference, also highlights the most important chapters of the manual.
- at Wikipedia - lists many alternative clients.
SVN on Windows
If you are under Windows, and you don't have experience with command line/cygwin, TortoiseSVN may be a good option, as it doesn't require the use of the command line or an specific GUI interface, integrating into the Windows Explorer.
- Download and Install TortoiseSVN.
- To checkout a copy of the s1mp3.org repository, right-click on the directory you are going to use and select SVN Checkout. In the dialog, use http://opensvn.csie.org/s1mp3/ as the repository URL. Click OK and the source will be downloaded