path: root/docs
diff options
authorGravatar Samuel Martin <s.martin49@gmail.com>2013-02-28 11:24:26 +0000
committerGravatar Peter Korsgaard <jacmet@sunsite.dk>2013-02-28 22:37:12 +0100
commit7a26f2f66360ddbcf1be5833d4834a72ccde769f (patch)
tree547d45c20792aa0e1d379cbdbe72621cbf45f491 /docs
parent5b02e6cad837da36c87cb5534b85f4ee8679cac5 (diff)
manual: minor fix in patch-policy.txt
Signed-off-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs')
1 files changed, 13 insertions, 3 deletions
diff --git a/docs/manual/patch-policy.txt b/docs/manual/patch-policy.txt
index 14c6efc538..0f55b26dc3 100644
--- a/docs/manual/patch-policy.txt
+++ b/docs/manual/patch-policy.txt
@@ -34,12 +34,18 @@ Most patches are provided within Buildroot, in the package
directory; these typically aim to fix cross-compilation, libc support,
or other such issues.
-These patch files should be named +<packagename>-<description>.patch+.
+These patch files should be named +<packagename>-<number>-<description>.patch+.
A +series+ file, as used by +quilt+, may also be added in the
package directory. In that case, the +series+ file defines the patch
application order.
+- The patch files coming with Buildroot should not contain any package version
+reference in their filename.
+- The field +<number>+ in the patch file name refers to the 'apply order'.
How patches are applied
@@ -56,8 +62,12 @@ How patches are applied
* If a +series+ file exists in the package directory, then patches are
applied according to the +series+ file;
-* Otherwise, patch files matching `<packagename>-*.patch` are applied
- following the +ls+ command order.
+* Otherwise, patch files matching +<packagename>-*.patch+
+ are applied in alphabetical order.
+ So, to ensure they are applied in the right order, it is hightly
+ recommended to named the patch files like this:
+ +<packagename>-<number>-<description>.patch+, where +<number>+
+ refers to the 'apply order'.
. Run the +<packagename>_POST_PATCH_HOOKS+ commands if defined.