Version 4 (modified by frhl, 13 years ago)


The ROPP Repository

The whole ROPP development system is divided into three areas:

  • ropp_src : deliverable code & supporting development system
  • ropp_doc : user and project documentation
  • ropp_test : Test Folder (test system and its results)

The repository for ROPP can be accessed via the Subversion server at the URL

For a complete list of Subversion commands see the  SVN reference manual

Checking out trunk

To  checkout the latest development (trunk) versions:

svn checkout . 
svn checkout . 
svn checkout .

This will check out the source code, documentation, and test folder, respectively to the local working directory.


Developments to ROPP should be made from, and committed to, a  branch rather than directly to the latest trunk version. This allows changes to be tested before merging the required changes back into the trunk. The trunk therefore represents a stable 'next potential release' state for ROPP. Branches can be temporary and might be for working on resolving a specific Trac Ticket.

Creating a branch

To create a branch of ropp_src from the trunk use the  svn copy ''SRC DST'' command:

svn copy<branch_name>

where <branch name> is a name of your choice which should reflect what you are working on. This prompts a text editor where you should describe the purpose of the new branch.

By default it is assumed that you wish to branch from the latest change version of the trunk. The -r flag can be used to specify the trunk revision from which a branch is required if this is not the latest. The -m flag could also be used when creating a branch to describe the contents of the branch.

svn copy [-r revision] SRC DST [-m "some text here"]

Similar branches may be created to store user versions of ropp_doc or ropp_test as required.

Checking out a branch

To make developments, the branch needs to be checked out to the local working directory for editing as above, specifying the path name for the required branch as

svn checkout<branch_name>

Working in a branch

Code developments are then made and logged within a branch as normal. To view the local changes made to a branch, use the  svn status command.

Committing changes to a branch

When changes to a branch are ready to be updated in the repository, the code needs to be committed using the  svn commit command.

svn commit -m "Some text here to describe the changes"

This will prompt a list of the changes to be committed.

When you are satisfied that all the changes you require to your branch have been committed and the ROPP Development Team are satisfied that it will be part of the next release, these changes will be merged back into the trunk by ROPP Admin.

Keeping up to date with changes to trunk

At some stage it may be necessary to update the trunk with latest developments while a user is still working in a particular branch. Users will be notified of any changes to trunk.

In order to keep a branch up to date with the latest version of the trunk while you are working on your branch, you may want to bring in the changes that have been made to the main trunk. This can be done using the  svn merge command. You must first change directory to your branch's working copy: e.g.

cd ${HOME}/<SVN_working_dir>/<branch name>

For a branch was created at revision NNNN, the following command will merge all changes made in trunk since the branch was created into your branch.

svn merge -r NNNN:HEAD

When you do this, you should see the list of updates that have been made to the trunk since you last brought in any changes (or since you branched). Note that this only results in changes to your working copy so you might want to commit them to the repository.

It is useful to preview the files which will be changed on performing a merge before going ahead using:

cd ${HOME}/<SVN_working_dir>/<branch name>
svn merge --dry-run -r NNNN:HEAD

The merge command can be used separately on subdirectories and files within a branch as required.

Further information on branches are available in  SVN reference: Branching and Merging

 Instructions for working with branches