Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Formatting and sending patches
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 "email@example.com"
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 a single patch:
$ git format-patch -1
For multiple patches, use:
$ git format-patch -n --cover-letter master
If you need to send more than one revision of the patch, please remember to use patch versioning:
$ git format-patch <-1 | -n --cover-letter master> --subject-prefix="PATCH v2"
Verify the generated patch files and then use git send-email to send them out:
$ git send-email --to firstname.lastname@example.org 00*.patch
You can find information on how to configure git to use gmail here: