Qu source code respository uses darcs. This file explains how you could participate as Qu developer.

The current repository contains the sources for version 1.21.04. I have upgraded my system and had to remove my original repository. We will rebuild the repository to reflect the latest Qu version (1.21.05) as soon as we can.

1. Install Darcs on your computer

You can get it from: http://www.darcs.net

Please read the manual!

2. Get all the source files

Go to you home directory then get all the source files from Qu's main respository.

> cd > darcs get http://www.germane-software.com/~qudevel/qu

It will create a directory called "qu".

3. Make changes

Edit the source files.

See the Darcs manual to add new files.

4. Create the patch

> darcs record -m "Patch Name" -a

Change "Patch Name" with the actual patch name, for example:

> darcs record -m "Fixes a rounding error bug in Integer.c"

The patch name should be descriptive, but short. Commments are not required, but are appreciated, and should describe the use case for the patch.

5. Send that patch to Marc

To send a single patch:

> darcs send --to marc@centrin.net.id -p "Patch Name"

To send a bundle of patches:

> darcs send --to marc@centrin.net.id

Please do isolate your patches; restrain yourself from sending a lot of different bug fixes and new features all as one patch. It is OK to send patch bundles, because the individual fixes are still isolated as individual patches. Take advantage of darc's block-level commits.

6. Wait for notification

Marc will send you a notification email that tells you whether or not your patch has been applied.

7. Occasionally, update your repository.

You don't need to do this to get your own patches, but you do need to do this to get other people's patches

> darcs pull -a

That's it.

Before you execute each command, you might want to read Darcs manual. You can also do something like:

> darcs pull --help

or

> darcs help pull