Sending Patches

From PyGarmin

We host our code on Launchpad in a bzr branch. The best way to submit a patch to be included in PyGarmin is to create a bzr branch of your own and send us a merge-directive, which is basically an annotated patch file.

First you need to get the code:

$ bzr branch lp:pygarmin your-branch
$ cd your-branch

Now you have a standalone branch, in which you can do your changes. After you've done your chagnes, you need to commit:

$ bzr commit

The commit won't get sent back to the trunk branch, but it will be recorded in the merge-directive. If you do a non-trivial change, you are encouraged to divide it into smaller chunks, and do one commit for each chunk. After your change is merged into the trunk, your commits will be visible in the history, and the code changes will be attributed to you, no matter how merges your patch into trunk.

After you've done your changes, it's time to submit your patch to our mailing list:

$ bzr send --mail-to=pygarmin-misc@lists.sourceforge.net

Now someone will review your changes and merge them into trunk.