diff options
author | Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> | 2012-11-27 11:59:17 +0000 |
---|---|---|
committer | Peter Korsgaard <jacmet@sunsite.dk> | 2012-11-27 17:07:42 -0800 |
commit | 65f66c170e6703cf1b75574e7aabea1302f51c50 (patch) | |
tree | 592519c5407a3fe8c264c7be39c08805870c40d1 /docs/manual/patch-policy.txt | |
parent | 1d989fafba761d29b3b2960bf388821d3ac0f6e7 (diff) | |
download | buildroot-novena-65f66c170e6703cf1b75574e7aabea1302f51c50.tar.gz buildroot-novena-65f66c170e6703cf1b75574e7aabea1302f51c50.zip |
manual: various fixes
Various consistency and correctness improvements.
Also removing some sentences that are not or no longer relevant.
Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be>
Acked-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs/manual/patch-policy.txt')
-rw-r--r-- | docs/manual/patch-policy.txt | 27 |
1 files changed, 14 insertions, 13 deletions
diff --git a/docs/manual/patch-policy.txt b/docs/manual/patch-policy.txt index b65855edb..9bc6537ca 100644 --- a/docs/manual/patch-policy.txt +++ b/docs/manual/patch-policy.txt @@ -2,8 +2,8 @@ [[patch-policy]] -Patch Policy ------------- +Patching a package +------------------ While integrating a new package or updating an existing one, it may be necessary to patch the source of the software to get it cross-built within @@ -16,15 +16,15 @@ and patches supplied within buildroot. Providing patches ~~~~~~~~~~~~~~~~~ -Additional tarball -^^^^^^^^^^^^^^^^^^ +Downloaded +^^^^^^^^^^ -If it is necessary to apply a patch set available as a downloadable -tarball, then add the patch tarball to the +<packagename>_PATCH+ -variable. +If it is necessary to apply a patch that is available for download, then it +to the +<packagename>_PATCH+ variable. It is downloaded from the same site +as the package itself. It can be a single patch, or a tarball containing a +patch series. -Note that the patch tarballs are downloaded from the same site as the -sources. +This method is typically used for packages from Debian. Within Buildroot ^^^^^^^^^^^^^^^^ @@ -72,14 +72,15 @@ modified. A message explaining what the patch does, and why it is needed, should be added in the header commentary of the patch. -You should add a +signed-off-by+ statement in the header of the each -patch to help with keeping track of the changes. +You should add a +Signed-off-by+ statement in the header of the each +patch to help with keeping track of the changes and to certify that the +patch is released under the same license as the software that is modified. If the software is under version control, it is recommended to use the -SCM software to generate the patch set. +upstream SCM software to generate the patch set. Otherwise, concatenate the header with the output of the -+diff -purN source.c.orig source.c+ command. ++diff -purN package-version.orig/ package-version/+ command. At the end, the patch should look like: |