Welcome to the Sispa project pages

This page:	http://sispa.sourceforge.net
Project page:	http://sourceforge.net/projects/sispa/
Mailing list:	currently being set up
Shell server:	ssh to sispa.sourceforge.net (developers only)

How to get the code
The easiest way to get the source code is to download one of the snapshots from the Sourceforge site. See the project page for details.

How to get the most recent code
The tools are in constant development, and the snapshots are normally slightly outdated. The project uses CVS tools to manage code changes, so if you need to most recent code you will need to download and install a copy of the CVS tools, if you do not already have them.

Use the following command to copy-out the entire source tree. This will create a subdirectory called ispa, into which all files will be copied.

cvs -z3 -d:pserver:anonymous@cvs.sispa.sourceforge.net:/cvsroot/sispa co ispa

The current CVS branch is ispa; and anyone can check out the current version, so an anonymous connection suffices. You should not get prompted for a password, but if you do then just press Enter.

How to update your source code
To keep your copy of the source up to date with changes made by the developers, use the cvs update command, like this:

cvs -z3 -d:pserver:anonymous@cvs.sispa.sourceforge.net:/cvsroot/sispa update

You need to be inside your source directory for this to work.

To join the project as a developer
If you wish to contribute as a developer, then please join this project. Because communication between yourself and the Sourceforge CVS server is encrypted, you will need the Secure Shell (SSH) utilities in addition to the CVS tools. Make sure that SSH is installed, and working correctly.

You first need to create a user ID on the Sourceforge web site. Click the Home link at the top of this page, and create a user account. Then, drop me an email and give me your Sourceforge ID, so that I can add you as a project developer.

You can test your SSH connection by logging on to sispa.sourceforge.net , using your Sourceforge ID and password. If you're in, then SSH must be working. This is necessary so that your home directory gets set up; without this, CVS will not work for you!

ssh -l loginname sispa.sourceforge.net

As a developer, you can retrieve and update your CVS copy of the source in the same way as a non-registered user.

How to submit your changes
Only registered developers can actually commit changes to the CVS source; anonymous access does not have that privilege. To submit your modifications and updates, use

export CVS_RSH=ssh
export CVSROOT=loginname@cvs.sispa.sourceforge.net:/cvsroot/sispa
cvs -z3 commit

Replace loginname with your Sourceforge login name. You may also need the cvs add and cvs remove commands. Look at the cvs man-page for details.