[linux] 08/08: README.source: Document convention for bracketted prefixes in changelog

[debian-kernel at lists.debian.org]

This is an automated email from the git hooks/post-receive script.

benh pushed a commit to branch sid
in repository linux.

commit 0f3b517e44873de3dd0398cb5341dd356d5b4967
Author: Ben Hutchings <ben at decadent.org.uk>
Date:   Tue Mar 15 01:29:45 2016 +0000

    README.source: Document convention for bracketted prefixes in changelog
---
 debian/README.source | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/debian/README.source b/debian/README.source
index 2a9f02c..0571890 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -89,6 +89,9 @@ Aside from those general rules:
     + Build fixes for configurations that we don't use
     + Fixes for lockdep false positives
 
+If you have time, please add bracketted prefixes to the upstream
+change list as described below under "Changelog conventions".
+
 Applying patches to the Debian kernel tree
 ==========================================
 
@@ -108,6 +111,25 @@ make -f debian/rules source
 
 The resulting source can be found below debian/build.
 
+Changelog conventions
+=====================
+
+If a change only affects some architectures, flavours or featuresets,
+this should be noted with a bracketted prefix on the changelog line:
+
+* [<fset>] Change to featureset <fset>
+* [<arch>] Change that affects Debian architecture <arch>
+* [<arch1>,<arch2>...] Change that affects Debian architectures
+  <arch1>, <arch2>, ...
+* [<arch>/<flavour>] Change that affects kernel flavour <flavour>
+  on Debian architecture <arch>
+* [<arch>/{<flavour1>,<flavour2>...}] Change that affects kernel
+  flavours <flavour1>, <flavour2>, ... on Debian architecture <arch>
+
+You can use wildcards to cover multiple values, e.g. 'arm*' for armel,
+armhf and arm64 architectures.  Also 'x86' is used to cover the Debian
+architectures amd64, i386 and x32.
+
 Kernel config files
 ===================
 Configuration files are constructed dynamically from a number of config

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/kernel/linux.git