Adding patches through git

WIP incomplete

Add kernel patches to be committed to the Preware feed by following this guide.

= Prerequisites =


 * SSH key generated, with the id_dsa.pub authorised for commital on git.webos-internals.org (rwhitby is able to do this)
 * GPL compliant patch to submit (preferably with a .patch extension)

= Initialising your local repository =


 * You will need to pull down the kernel/patches repository as a starting point with

A worked example is as follows:


 * Create a directory for your patch(es) and copy them in there.

= Tag patches and submit to git =


 * Find the next available git tag with

In the following case, the next tag is v1.4.1-10:


 * Tag the files with a meaningful commit message and the tag from the previous step:


 * Send the tagged files to the upstream repository with

For example:

= Commit the tagged files to git =

Committing the tagged files is the following three step process:


 * git add filenames
 * git commit -m "commit message" filenames
 * git push

Worked example:

= Uh-oh, I screwed up a commit - how do I remove a file? =

If you inadvertently commit a file in error, it is easy to remove with

Worked example:

If you have modified the file, you will need to force the commit with the -f flag, as follows:

= git conceptual tutorial =

An excellent conceptual tutorial on how git works is available at http://www.eecs.harvard.edu/~cduan/technical/git/ courtesy of Charles Duan.