Introduction

This sections lists several typical tasks that users and developers will perform frequently. It implies that the SIT environment has already been setup as explained in Environment setup.

Before issue any of commands listed below make sure that you use correct gateway

ssh psdev;

check from psdev that ssh yakut works for you (come back to psdev);
kindly ask Andy to add you account to our AFS group;
use correct sequence of SVN commands.

Tasks

Switching to a different release or build options

To switch to "newest" release:

sit_setup newest

To switch to a numbered release and use debug build:

sit_setup 1.2.3 dbg

To use debug build

sit_setup dbg

Creating test release based on some numbered release

cd <test-area>
newrel 1.2.3 test-1.2.3
cd test-1.2.3
sit_setup

Check out package from repository

To check out package HEAD

addpkg MyPackage HEAD

To check out the same tag as in the release

addpkg MyPackage

To check out specific tag

addpkg MyPackage V00-00-00

Create completely new package

This will create basic structure for a regular package - package directory, SConscript file, doc/README, and doc/ChangeLog.

newpkg MyNewPackage

Create new package in Subversion

psvn newpkg MyNewPackage

and check it out

addpkg MyNewPackage

Building the release

scons

or

scons TRACE=1

Use higher TRACE numbers for verbose output.

To run all unit tests in the release

scons test

Committing changes to a package

cd <package>
svn commit -m "Log message for this commit"

List existing tags for a package

cd <package>
psvn tags

or

psvn tags <package>

Creating new tag for a package

Before you create new tag run 'svn update' command:

cd <package>
svn update
psvn tag V01-02-03

or

svn update <package>
psvn -p <package> tag V01-02-03