Developers should first register with SourceForge using the "New User via SSL" link on the  SourceForge.net home page. SourceForge provides access to JavaSeis source code using "ssh" and "cvs".

After the project administrator adds you as a developer, you will need to set up ssh on your Unix workstation.

To set up you workstation for ssh:
> ssh-keygen -t dsa -C username@shell.sf.net

You will get request for a pass phrase (i.e. password) that will be requested every time you use "ssh" to access SourceForge, and the location of the "id_dsa.pub" file, typically in "~/.ssh/id_dsa.pub".  Edit this file, or "cat" it to standard output so it will be available for pasting into SourceForge.

For the adventurous developer working in Unix/Linux, every time you use an ssh command, you will be prompted for your “passphrase”.  This can be circumvented using the “ssh-agent” facility.  This program stores your keys and supplies them to other “ssh” programs. Here’s a quick set of commands to set this up for csh users:

> setenv SHELL csh

> eval `ssh-agent`

> ssh-add

Bash and ksh users will need to adjust the syntax above. The ssh-agent command prints out a set of commands that start up a background process with a port number and temp file.  The second command adds the keys in your “id_dsa.pub” file.  You will  be prompted for your passphrase once at this point.  After that, you will not need to enter your passphrase until you log out of your workstation.

Next, log in to your SourceForge account. Click on the "my sf.net" tab at the top of the SourceForge page. If you do not see any projects listed, the Administrator has not yet added you as a project member.  Bug him.

Click on the "Account Options" link a the top of the page.  This should take you to the "Acccount Maintenance" page.  At the bottom of the page is a link labled "[Edit SSH Keys for Shell/CVS]. Click on this link to bring up the ssh key window. In a unix window, cat the contents of "id_dsa.pub", then copy and paste into the dialog box labled "Authorized Keys". Make sure it is a single line in the box, then click the "Update" button.

You are now ready to download source from the CVS repository.

See the SourceForge site docs for details on the CVS checkout command. On Unix/Linux, you can set:

> setenv CVS_RSH ssh

> setenv CVS_ROOT :ext:username@javaseis.cvs.sourceforge.net/cvsroot/javaseis

> cd location_for_javaseis

> cvs checkout javaseis

Which will create the javaseis directories and download the source. Change it as you wish, then check it back in if you think you can get past me ;-)