|
Packit |
cac203 |
# How to Submit Patches for libteam #
|
|
Packit |
cac203 |
=======================================
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
Send changes to libteam as patches to libteam@lists.fedorahosted.org
|
|
Packit |
cac203 |
with copy to jiri@resnulli.us.
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
Avoid using attachments because usually it doesn't work.
|
|
Packit |
cac203 |
In another words, inline the patch inside the e-mail's body.
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
The simplest workflow to send changes is using git. The following
|
|
Packit |
cac203 |
steps will guide you to do the task.
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
1) Clone the source code on your local machine.
|
|
Packit |
cac203 |
$ git clone https://github.com/jpirko/libteam.git
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
2) Create a local branch for you
|
|
Packit |
cac203 |
$ cd libteam
|
|
Packit |
cac203 |
$ git checkout -b testbranch
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
3) Do your changes
|
|
Packit |
cac203 |
<<do some changes>>
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
4) Commit them to the repository
|
|
Packit |
cac203 |
$ git commit -a -s
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
5) Optionally, you can verify how it looks like in the repo
|
|
Packit |
cac203 |
$ git show
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
6) Extract the patch in a standard format into /tmp directory
|
|
Packit |
cac203 |
$ git format-patch origin -o /tmp --subject-prefix "patch libteam"
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
7) Use checkpatch script from the kernel sources to find possible styling
|
|
Packit |
cac203 |
issues in your patch:
|
|
Packit |
cac203 |
$ path-to-kernel-sources/scripts/checkpatch.pl /tmp/0001-somepatch.patch
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
8) Use git send-email to send the patch*.
|
|
Packit |
cac203 |
$ git send-email /tmp/0001-somepatch.patch \
|
|
Packit |
cac203 |
--to=libteam@lists.fedorahosted.org --cc=jiri@resnulli.us
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
And you are done :)
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
* You may need to configure smtp in order to send emails, so please
|
|
Packit |
cac203 |
check the "Example" section in the reference [3] below as a start.
|
|
Packit |
cac203 |
|
|
Packit |
cac203 |
Additional references about git:
|
|
Packit |
cac203 |
[1] http://git-scm.com/docs/gittutorial
|
|
Packit |
cac203 |
[2] http://git-scm.com/docs/gitworkflows.html
|
|
Packit |
cac203 |
[3] http://git-scm.com/docs/git-send-email
|
|
Packit |
cac203 |
[4] http://git-scm.com/book
|