========================
Installation procedure
========================
This a simple text version of install guide.
You may find more detailed information about
the TSP installation and usage directly from:
http://download.savannah.nongnu.org/releases/tsp/tsp_programming_guide-1.1.pdf
or
http://download.savannah.nongnu.org/releases/tsp/tsp_programming_tutorial-1.0.pdf

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  https://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 you want to be developper (allowed to commit modification, ask on tsp-devel@nongnu.org)

 * 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 -t dsa
	[ http://savannah.gnu.org/account/editsshkeys.php ] Change Authorized Keys page (logged in)
	and paste you key generated in ~/.ssh/id_dsa.pub, then wait next cron tab update (6h)

 * Extract CVS tree 
        see explanation here: https://savannah.nongnu.org/cvs/?group=tsp
	Move into the local directory where you want to keep your local copy of the CVS tree. 
	For example:
 	%  cd /where_you/want/it/to/go
 	Download the CVS tree structure (substitute user with your login name):
 	% export CVS_RSH=ssh
	% cvs -z3 -d:ext:myUserName@cvs.savannah.gnu.org:/sources/tsp co tsp

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

How to configure :
------------------
% cd tsp_build                     # change to the toplevel directory. MUST BE DIFFERENT from
                                   # the one where the source was installed

% cmake <path-to-tsp-source>       # run cmake (see http://www.cmake.org)
You can choose to use debug / opt compilation, and exclude parts of tsp (java, provider, consumer)
For more information 
% ccmake <path-to-tsp-source>

How to compile :
---------------

% 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

