========================
Installation procedure
========================

1) How to get sources
  1a) Downoload tarball
  1b) use CVS checkout

2) Compilation

3) Use TSP

========================
1) How to get sources
========================

1a) Download tarball
--------------------
Go to  http://savannah.nongnu.org/files/?group=tsp
Select & download the tar version you want to use
% gzip -cd tsp-xxx.tar.gz | tar xvf -  # unpack the sources

1b) Use CVS
--------------------
 * Create an account on savannah
	https://savannah.gnu.org/account/register.php
	If yoy want to be developper (allowed to commit modification, ask tsp@astrium-space.com)

 * Create and register a SSH key for this account
	In fact, you can simply do this by typing:
	echo "Protocol 2" > ~/.ssh/config
	ssh-keygen -dsa
	[ http://savannah.gnu.org/account/editsshkeys.php ] Change Authorized Keys page (logged in)
	and paste you key generated in ~.ssh/identity.pub, then wait next cron tab update (6h)

 * Extract CVS tree 
	Move into the local directory where you want to keep your local copy of the CVS tree. 
	For example:
 	%  cd /opt
 	Download the CVS tree structure (substitute user with your login name):
 	% export CVS_RSH=ssh
	 % cvs -z3 -dmyUserName@subversions.gnu.org:/cvsroot/tsp co tsp

========================
2) Compilation procedure
========================

How to configure :
------------------
% cd tsp                           # change to the toplevel directory
% ./configure                      # run the `configure' script
You can choose to use debug / opt compilation, and exclude parts of tsp (java, provider, consumer)
For more information 
% ./configure --help

How to compil :
---------------
The configure script will tell you what to do then. You should now do either
% source src/scripts/tsp_dev.login  [csh/tcsh]       
Or
% . src/scripts/tsp_dev.login.sh    [sh/bash/zsh/...]
And then you may build with a simple                   
% cd src; make           


========================
3) Use TSP
========================
A simple example of TSP could be
% cd $DEVBASE/tests/auto
% ./tsp_autotest001

Or more fun
% cd $DEVBASE/tests/demo
% ./tsp_demo_gdisp

