[Buildroot] [PATCH] docs/manual: document the new patch naming convention

Thomas De Schampheleire patrickdepinguin at gmail.com
Sun Oct 12 18:11:13 UTC 2014


"Yann E. MORIN" <yann.morin.1998 at free.fr> schreef:
>To ease generating patches, we now use a naming convention that is in
>line with what git-format-patch does, that is:
>  - do not prefix patches with the package name
>  - prefix patches with a 4-digit mber
>  - start numbering at 0001
>
>Signed-off-by: "Yann E. MORIN" <yann.morin.1998 at free.fr>
>Cc: Peter Korsgaard <jacmet at uclibc.org>
>Cc: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
>Cc: Thomas De Schampheleire <patrickdepinguin at gmail.com>
>Cc: Arnout Vandecappelle <arnout at mind.be>
>Cc: Samuel Martin <s.martin49 at gmail.com>
>---
> docs/manual/patch-policy.txt | 20 ++++++++++++++------
> 1 file changed, 14 insertions(+), 6 deletions(-)
>
>diff --git a/docs/manual/patch-policy.txt b/docs/manual/patch-policy.txt
>index 745f58d..098fbce 100644
>--- a/docs/manual/patch-policy.txt
>+++ b/docs/manual/patch-policy.txt
>@@ -31,16 +31,24 @@ 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>-<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.
>+These patch files should be named +<number>-<description>.patch+.
> 
> .Notes
> - 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'.
>+- The field +<number>+ in the patch file name refers to the 'apply order',
>+  and shall start at 1; it is preferred to prefix with 0, so that there are 4
>+  leading digits, like 'git-format-patch' does.

What about:
It is preferred to pad the number with zeros up to 4 digits, like ...
?


>+  E.g.: +0001-foobar-the-buz.patch+
>+- Previously, it was mandatory for patches to be prefixed with the name of
>+  the package, like +<package>-<number>-<description>.patch+, but that is
>+  no longer the case. Existing packages will be fixed as time passes. 'Do
>+  not prefix patches with the package name.'
>+- Previously, a +series+ file, as used by +quilt+, could also be added in
>+  the package directory. In that case, the +series+ file defines the patch
>+  application order. This is deprecated, and will be removed in the future.
>+  'Do not use a series file.'
>+
> 
> ==== Global patch directory
> 





More information about the buildroot mailing list