1. Create a SourceForge user account. In the instructions below, you are assumed to be logged into the sourceforge.net site with this account from a Win 2000/XP PC. For simplicity, they also assume that you are accessing the spikecluster repository, although it is straightforward to substitute another SourceForge project.
2. Install Tortoise CVS on your local machine and create a folder to use as a 'sandbox'. Enter this folder in the Included Folders field of the Advanced tab of the Tortoise CVS Preferences. It is also useful to deselect the Prune impty folders option in the Policy tab of the Preferences (this can prevent empty modules from becoming inaccessible).
3. Install the complete PuTTY package, including Pageant.

1. Generate an SSH-2DSA public/private key pair using PuTTYgen and assign a passphrase.
2. Save the private key in the directory containing the Pageant executable. Name it, e.g., SourceForge.ppk.
3. Go to your SourceForge Account Maintenance page and scroll to Host Access Information. Upload the public key.
4. Attempt to log into the CVS server (e.g., user@cvs.sf.net) using SSH. Although the server will not allow you to actually connect, it will create a home directory for you on the SourceForge shell. This only needs to be done once for any user account.
5. When performing CVS operations, Pageant will allow secure access to the SourceForge CVS server without requiring repeated manual logins. To do this, start Pageant, right-click on the system tray icon and select Add Key. Select your SourceForge private key and enter the passphrase.

1. Right click in the SANDBOX and make a new directory with the name of the module to be created. Right click on this directory and choose CVS->Make New Module.
2. Enter the following CVSROOT:      :ext:USER@cvs.sourceforge.net:/cvsroot/spikecluster
3. Confirm the name of the new module in the Module field and click and click OK. If successful, a green check mark appears on the icon for the module folder on your local machine.
4. The newly created module will appear in the SourceForge WWW CVS browser after a delay of upto a few hours. It is, however, available for check out and use immediately after creation.
5. Sourceforge does not support the Fetch List button in Tortoise CVS. Use the Sourceforge WWW CVS browser to see a list of available modules.

1. Right click in the SANDBOX directory and click CVS Checkout. Enter the following CVSROOT: :ext:USER@cvs.sourceforge.net:/cvsroot/spikecluster        and enter the name of the desired MODULE.
2. If a folder with the name MODULE already exists in the SANDBOX, the CVS files from the repository for that MODULE are copied to that folder. If no such folder exists, one is created before copying files. In either case, the icon for the folder should show a green check mark to indicate that it is managed by CVS.

1. If the icon for a file in a local CVS directory has a purple ? mark overlaid, the file is not yet part of the CVS tree. In this case, right click on it and choose CVS Add.
2. If a file is part of the CVS tree but has been modified since it was last checked out or updated, it will have an orange + mark. To merge the local changes into the CVS repository, select all files that need to be committed, right click and choose CVS Commit.
3. Enter any desired comments and click OK. The icons of the committed files change from orange + overlays to green check marks.

• Right click on the module folder and select CVS->Release. You will be asked whether the local files should be deleted. Note that care is needed if you do not delete them, as they are no longer managed by CVS and extra effort will be required to merge them back into the repository code.

1. Collect all of the files (.m, .fig, documentation, etc.) needed for a user to install the code on a local machine and zip them into a single file. Include the release number in the name of the zip file. Place the zipped file at the root of your hard drive for easy access.
2. FTP to upload.sourceforge.net and login as anonymous with your email address as the password. Set the FTP client to binary mode (bin on command-line clients).
3. Change the current directory on the remote server to /incoming and upload the release zip file.
4. Go to the Project Admin page and select Releases. Scroll down to File Release Packages. If this is the first time this package is being released, first enter a new Package Name at the bottom of the page. Once a package has been defined, the release zip file uploaded above can be added using Add release, entering release notes/details and selecting the newly uploaded file. Note that there may be a delay of a few minutes after the upload before the file appears on this WWW page.

To upload files to these directories, use SCP/SFTP to securely copy files to shell.sf.net.

Uploading Screenshots

1. Go to the Project Admin page on SourceForge and select Screenshots.
2. Image files meeting the above specifications can be uploaded from this page. Screenshot files can also be reordered and deleted here.

• Every file in a CVS repository carries a revision number which is incremented every time that file is committed (the full revision number is actually 1.###, but ordinarily only the ### part changes. This process happens automatically every time changes are committed.
• A file or collection of files can further be tagged at any given time to provide a development snapshot. This is accomplished in Tortoise CVS by right-clicking on the file(s) and selecting CVS->Tag. Modules should as a rule be tagged when they are included in a file release to allow easy recreation of the code state for any release.
• The change history for text files is summarized (by Tortoise CVS) using the CVS->History, CVS->Revision Graph and CVS->Annotate commands. The History and Revision Graph commands show the time, author and comments for each revision made to a file. The Annotate command shows the revision and author responsible for each line in the file.
• Particular revisions/tags (and branches; see notes below) for any file or collection of files can be retrieved using CVS->Update Special.
• CVS Branch allows more complex code development paths.

• The entire CVS repository can be backed up by saving a copy of the nightly tarball at: http://cvs.sourceforge.net/cvstarballs/spikecluster-cvsroot.tar.bz2. This file is updated once a day when write activity occurs in the CVS repository.
• As file releases are not managed by SourceForge, local backups should be saved when they are uploaded to SourceForge.
• The project directories (including www space) can be backed up by ssh'ing to shell.sf.net and typing: tar -cvzf spikecluster_project.tar.gz /home/groups/s/sp/spikecluster/ The resulting file can be copied off of the SourceForge shell via SCP.

CVS/SourceForge Overview

SSH Access

Shell/WWW Services

Tortoise CVS

WinCVS

Matlab Source Control Integration