Contributing Code

Pre-requisites

You need Bazaar

I have a question - is the copyright of my code assigned to MySQL AB? ANSWER: Absolutely not.

Login Setup

• Get a launchpad account at https://launchpad.net/+login
• When logged in, setup your SSH keys
  • Click your name (top right corner)
  • Click Change Details link (upper right)
  • Click SSH Keys button (middle of page)
  • Upload your public SSH key (How do I get a public key?)
• Register yourself

bzr launchpad-login [your id]

Getting the code

You should prepare a directory to keep bzr work in

mkdir /some/working/dir
bzr init-repo /some/working/dir

You should first create a clean repo.

cd /some/working/dir
bzr branch lp:drizzle

You can see the current history with:

cd /some/working/dir
cd drizzle
bzr log | more

You can now create a working copy of the clean repo

cd /some/working/dir
bzr branch drizzle drizzle-mypatch-example
cd drizzle-mypatch-example

NOTE: Use a more descriptive name then my-patch-example

You should now Compile Drizzle.

Adding your contribution

With a working version, you can commence making changes in your new branch, committing code regularly to your local working copy.

cd /some/working/dir
cd drizzle-mypatch-example
# Make Changes
bzr commit

Prior to publishing your completed work, you need update your local copy of the trunk, and then merge any changes into your working branch.

Merging recent changes

Update your local trunk.

cd /some/working/dir  
cd drizzle
bzr pull   

Updating your local branch.

cd /some/working/dir
cd drizzle-mypatch-example
bzr pull

Verify differences carefully

bzr diff

Publish your branch

When all changes are merged and your changes are all consistent you can push your branch to LaunchPad

bzr push lp:~[yourloginid]/drizzle/[branch-name]

Propose branch to the maintainers to be merged into the main trunk.