Formatting and sending patches
Clone this wiki locally
You commit locally to your git tree and then prepare patches that you send to the mailing list.
First, make your name and email address are configured for git:
$ git config user.name "Your Name" $ git config user.email "firstname.lastname@example.org"
Also configure git to detect renames and copies to make
git format-patch output easier to review:
git config --global diff.renames copies
Then, make your modifications in your own private branch:
$ git checkout -b features/foo # branches from master
To commit changes, do:
$ git commit -a -s # commit everything, signoff the patches
Please prepare a commit message for every commit:
The sign-off procedure is explained here:
Once you have commits you want to send out, use git format-patch to generate them.
For multiple patches, use:
$ git format-patch -n --cover-letter master
for a single patch:
$ git format-patch -1
Verify the generated patch files and then use git send-email to send them out:
$ git send-email --to email@example.com 00*.patch
If you need to send more than one revision of the patch, please remember to use patch versioning:
$ git format-patch --subject-prefix="PATCH v2"
You can find information on how to configure git to use gmail here: