[Buildroot] [git commit branch/2022.05.x] docs/manual: patch subjects shall not be numbered
Peter Korsgaard
peter at korsgaard.com
Sat Sep 17 20:22:18 UTC 2022
commit: https://git.buildroot.net/buildroot/commit/?id=ba675342e1581a9f76a05d1f6e0e0b86a108d639
branch: https://git.buildroot.net/buildroot/commit/?id=refs/heads/2022.05.x
The script "utils/check-package" checks that patch email prefix are
not be numbered. See:
https://git.buildroot.org/buildroot/tree/utils/checkpackagelib/lib_patch.py?h=2022.08-rc1#n42
The error message recommends to generate patches to be included in
Buildroot with the command 'git format-patch -N'.
The patch policy section in the Buildroot manual does mention that.
This commit adds a note about that requirement.
Signed-off-by: Julien Olivain <ju.o at free.fr>
Signed-off-by: Yann E. MORIN <yann.morin.1998 at free.fr>
(cherry picked from commit 5ac1b1866db3e3e386d609c0f3b502789f6f8da5)
Signed-off-by: Peter Korsgaard <peter at korsgaard.com>
---
docs/manual/patch-policy.txt | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/docs/manual/patch-policy.txt b/docs/manual/patch-policy.txt
index e704a0d3f3..063ef984d8 100644
--- a/docs/manual/patch-policy.txt
+++ b/docs/manual/patch-policy.txt
@@ -44,6 +44,11 @@ These patch files should be named +<number>-<description>.patch+.
- The field +<number>+ in the patch file name refers to the 'apply order',
and shall start at 1; It is preferred to pad the number with zeros up to 4
digits, like 'git-format-patch' does. E.g.: +0001-foobar-the-buz.patch+
+- The patch email subject prefix shall not be numbered. Patches shall
+ be generated with the +git format-patch -N+ command, since this
+ numbering is automatically added for series. For example, the patch
+ subject line should look like +Subject: [PATCH] foobar the buz+ rather
+ than +Subject: [PATCH n/m] foobar the buz+.
- 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
More information about the buildroot
mailing list