__READ ME__

Social Versioning System
version 0.4 - preview release, October 2005
http://www.spring-alpha.org/svs

Simon Yuill
simon@lipparosa.org


Copyright (C) 2005 Simon Yuill

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA



__Notes__

This is a PREVIEW release of svs 0.4.  We have made it available for those
who wish to look at the code.


__Installation__

Check that you have the necessary dependencies installed, these are listed below.
If any are missing, you can download and install them from the URLs provided.

If you have a previous version of SVS installed it is recommended to remove it
before installing this new version.

Installation instructions:

Unpack svs-x.x.tar.gz:

	tar -zxvf svs-x.x.tar

Enter the svs-x.x directory:

	cd svs-x.x

To install run:

	python ./setup.py install --prefix=/usr/local

As this is an early development version of SVS, it is recommended that you 
install it in your /usr/local directory rather than the main system directories 
for Python packages.  


For a detailed description of the installation process see:

http://www.spring-alpha.org/svs/pages.php?content=installation



__Dependencies__

Python 2.3 or higher is recommended.

visualisation and interface graphics
- tkinter: http://www.tcl.tk
- Soya3D (for 'svs_soya'): 

networking
- twisted: http://twistedmatrix.com

maths and data structures
- pygraphlib: http://pygraphlib.sourceforge.net
- Numeric Kinds: http://cvs.sourceforge.net/viewcvs.py/numpy/kinds/
- Polygon: http://www.dezentral.de/soft/Polygon/

CVS access (for 'svs_analysis')
- Python CVS Library: http://software.cnx.rice.edu/downloads/python/pycvs


For details see:

http://www.spring-alpha.org/svs/pages.php?content=installation



__Distribution__

SVS is distributed under the terms of the GNU General Public License.
For details see the file LICENSE included with this distribution.


__Changes__

version 0.4 (October 2005)
1.) 'svs_simtools' package temporarily removed.
2.) 'svs_examples' becomes separate 'example' package.
3.) 'tutorials' package added - separate from main distribution.
4.) 'svs_core.dev' package added.
5.) wxWidgets toolkit integrated - see 'svs_core.gui.clientgui_wx.py'.

version 0.3 (August 2005)
1.) major development on 'svs_simulation' package.
2.) 'svs_simtools' package added.
3.) 'svs_soya' package added (experimental client with Soya3D interface).
4.) 'svs_tracking' package renamed 'svs_analysis'.
5.) 'svs_examples' package renamed 'svs_demogame_examples' and included
in main distribution.
6.) 'svs_core.geometry' package moved to 'svs_simulation' and renamed
'numdata'.
7.) 'time' package added to 'svs_core'.
8.) 'objectmanager.py' added to 'svs_core.utilties'.
9.) 'whisker.py' added to 'svs_demogame_examples'.
