Contributing Code

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

Tickets allow patch tracking in addition to bug and enhancement request tracking. The active tickets show current bugs which need fixing as well as other users' enhancement requests. If you fix or implement one of these, 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 once you've modified your code is easy. From the Terminal, change to the Senuti folder. If it is in your home directory, this would be:

cd ~/senuti

and then type:

svn diff > myPatch.diff

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

Note 1: If you have created new files, you should do:

svn add Path/To/YourFileName

for each file before running svn diff .

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

Please be sure your patch has been thoroughly tested and conforms to the Senuti coding style guidelines.