Subversion Access

Most software projects, including Razuna, use a version-control system to keep track of their source code and its revisions behind the scenes, and periodically release versions of the software for public use. Most users will never want to use Subversion, because they will only install the downloadable versions. However, developers interested in contributing to Razuna by testing or fixing bugs will also need to have access to the code that is in development.

This development code can only be accessed via Subversion. In this article, we'll cover the basics of connecting to the Razuna Subversion repository. This article assumes that you have Subversion (or at least a Subversion client) installed already, and it only covers the most basic commands.

The Razuna Subversion Repository Architecture

The basic idea of Subversion is that the source code and revisions are kept in a repository on a server. Users connect to the repository by using a client program, which allows the user to check out, view, edit, patch, and commit changes to the source code files (only people with given permissions can commit changes).

The Razuna subversion repository is at svn://svn.sixsigns.com/razuna/. Within the repository, there are three sections:

• trunk: svn://svn.sixsigns.com/razuna/trunk/ contains the latest development code
• tags: When a version is released to the public, the source code is "tagged" with the version number. So for instance, Razuna 1.1 can be found at svn://svn.sixsigns.com/razuna/tags/1.1/
• branches: We sometimes test the current code in the trunk under different circumstances and stuff create a branch of the existing version. If not instructed you should not checkout from here.

Checking out of the Razuna code

Once you have Subversion installed, the first step you'll need to do is to check out the code, which basically means that you will download a version from the repository to your computer. To do this, make an empty directory for your copy of the code, change to that directory, and execute the checkout command on the trunk, branch, or tag you are interested in. For instance, to check out the trunk (latest development version):

svn co svn://svn.sixsigns.com/razuna/trunk/. (note the "dot" at the end)

The result will be that the directory is filled with all of the needed Razuna files, as well as some hidden .svn sub-directories containing Subversion information.

Updating to the latest Razuna code

If you would like to update to the latest version now available, use the update command, after first changing to the directory where you checked out the code originally:

svn update

Related Topics

Installing Razuna with Subversion
Updating Razuna with Subversion
Convert existing Razuna installation to Subversion