Contributing Code

Once you have checked out the Adium source code, you can fix bugs or implement features and then submit your changes as a patch for inclusion in Adium.

Finding a bug or a feature request to work on

If you fix or implement a ticket, your patch should be attached to the relevant ticket. If you fix a bug which is not listed, please create a ticket for your patch and attach the patch to that ticket.

Creating the patch

Creating the patch once you've modified your code is easy.

1. From the Terminal, change to the Adium folder. If it is in your home directory, this would be:

   cd ~/adium
   

2. and then type:

   hg export > myPatch.diff
   

   where myPatch is a name for your patch. This will create a patch file which has only the changes you've made.

3. If you have created new files, you should do:

   hg add
   

4. If you modify or create nibs in Interface Builder, you'll need to also compress (zip, tgz, or tbz) the nib and send it. nib bundles include a binary file which diff doesn't capture.

5. Please be sure your patch has been thoroughly tested and conforms to the Adium coding style guidelines.
   → You can contact the current for help and advice.

6. Additionally, please include your full name is in Copyright.txt as part of your patch. It helps us keep track of people that have contributed to Adium and credits you for your contribution.

Submitting the patch

Be sure set the Patch field of your trac ticket (if you can) to ensure that we see your patch in a timely fashion. Otherwise, email the development mailing list or the  Patch Master.