1. Download the code

This project has no Git repository. If you are the project lead, you should probably give it one by using the ff init command. This command will allow you to clone an upstream Git repository, or to create one from a source directory on your local filesystem.

2. Make your changes

If you need an introduction to Git, the Git homepage is a good place to start.

In short, just edit the code and commit your changes (to your local repository) using git commit. Note that when it's time to submit your work, only committed changes will be part of the submission.

3. Install the ff Script

To submit your changes, you'll need to install the ff script on your local system. This script provides a command-line interface for several FOSS Factory features. Feel free to view the script before installing it.

To install it, just place it anywhere in your path and make sure it's executable. For example, if you are running Ubuntu, you could type this:

sudo curl http://www.fossfactory.org/ff -o /usr/local/bin/ff
sudo chmod a+x /usr/local/bin/ff

To use the script, start by typing ff help. You can get more detailed help on any of the commands by typing ff help <command>.

4. Set up Git write-access

To gain special access to FOSS Factory's Git repositories, type:

ff setup

This will transfer your SSH public key to the FOSS Factory server. Note that you will only have push access to repositories for which you are the project lead, and to your own code submission repositories.

5. Submit your work

To make a submission to this project, type:

ff submit p249

This will prompt you for your submission comments, then it will create the submission. The project lead will be notified automatically.