Submit patches to Openembedded

From KoanSoftware Wiki
Jump to navigation Jump to search

Submit patches to Openembedded (core)

Contributions to the Yocto Project and OpenEmbedded are very welcome. You can read the official [Yocto contributor-guide]

Set up git

In this case I have a subscribed the openembedded-devel mailing list with a gmail.com account and I sign my patch with another account. Properly configure git (using tekkub@gmail.com as an example user)

On Debian / Ubuntu (Note: Fedora uses `yum` OpenSuse uses zypper or yast)

sudo aptitude install git-core git-email

These are important to the commit meta-data

git config --global user.name "Myself Me"
git config --global user.email "myname@mydomain.com"

Any Google Apps account

git config --global sendemail.smtpserver smtp.gmail.com
git config --global sendemail.smtpserverport 587
git config --global sendemail.smtpencryption tls
git config --global sendemail.smtpuser tekkupl@gmail.com

Committing your patch

Commit with a concise and descriptive message - one that explains your changes in a way others get a short overview without looking at the code.

Move to oe-core directory or whereever you keep your clone of the repo

cd oe-core

Add the modified file

git add path/recipename

Add a comment including my signature "Signed-off-by: Your Name <name@domain.com>"

git commit -s
   recipename: brief description
   * Longer description
   * if
   * required


In case you are sending patches for meta-openembedded or any layer other than openembedded-core, please add the appropriate prefix so that it is clear which layer the patch is intended to be applied to:

git format-patch --subject-prefix="meta-oe][PATCH" ...


Please substitute "PATCH" with "PATCH v2" if you are submitting a revised version after addressing feedback (or v3, v4 etc.)

For multiple commits you can substitute -1 above with -N (where N is the number of commits)


Sending using git-send-email

To send just the top commit on your current branch (substitute mailing list address as appropriate):

git send-email --to=openembedded-core@lists.openembedded.org patchfilename

Community review

Your patch will be sent to the mailing list and should be immediately visible on http://patches.openembedded.org/ .