aboutsummaryrefslogtreecommitdiffstats
path: root/debian/README.source
diff options
context:
space:
mode:
authorBen Hutchings <ben@decadent.org.uk>2016-05-18 04:00:34 +0100
committerBen Hutchings <ben@decadent.org.uk>2016-05-18 04:34:27 +0100
commit4bd293fc1dcc00dca940d65a72ed228de1b2f8e8 (patch)
tree1e8c8d986dbccf6c8216a769a1577e053590923c /debian/README.source
parent7275f364d987942bb00fdf9187f2a75202be4a61 (diff)
downloadkernel_replicant_linux-4bd293fc1dcc00dca940d65a72ed228de1b2f8e8.tar.gz
kernel_replicant_linux-4bd293fc1dcc00dca940d65a72ed228de1b2f8e8.tar.bz2
kernel_replicant_linux-4bd293fc1dcc00dca940d65a72ed228de1b2f8e8.zip
debian/README.source: Rewrite and expand explanation of kernel config file construction
Diffstat (limited to 'debian/README.source')
-rw-r--r--debian/README.source41
1 files changed, 31 insertions, 10 deletions
diff --git a/debian/README.source b/debian/README.source
index fa5074e1eca0..642baa0aa83c 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -132,16 +132,37 @@ architectures amd64, i386 and x32.
Kernel config files
===================
-Configuration files are constructed dynamically from a number of config
-files under debian/config, in the following order:
-
-- config
-- kernelarch-%kernel-arch/config
-- %arch/config
-- %arch/config.%flavour
-- featureset-%featureset/config
-- %arch/%featureset/config
-- %arch/%featureset/config.%flavour
+Each kernel configuration file is constructed dynamically from a
+number of files under debian/config. They are read in the following
+order, such that files later on the list can override settings from
+earlier files. Most of the files are optional and the filenames can
+generally be overridden by explicit lists (possibly empty) specified
+in the 'defines' files.
+
+1. Common:
+ - Default filename: config
+ - Filename list: [image]configs in defines
+2. Per kernel architecture:
+ - Filename: kernelarch-<karch>/config (optional)
+3. Per architecture:
+ - Default filename: <arch>/config
+ - Filename list: [image]configs in <arch>/defines
+4. Per architecture and flavour:
+ - Default filename: <arch>/config.<flavour> (optional)
+ - Filename list: [<flavour>_image]configs in <arch>/defines
+5. Per featureset:
+ - Default filename: featureset-<fset>/config (optional)
+ - Filename list: [image]configs in featureset-<fset>/defines
+6. Per architecture and featureset:
+ - Default filename: <arch>/<fset>/config (optional)
+ - Filename list: [image]configs in <arch>/<fset>/defines
+7. Per architecture, featureset, and flavour:
+ - Default filename: <arch>/<fset>/config.<flavour> (optional)
+ - Filename list: [<flavour>_image]configs in <arch>/<fset>/defines
+
+You can check the final list of configuration files by reading
+debian/rules.gen. Each binary-arch_<arch>_<fset>_<flavour>_real
+rule passes the list to debian/rules.real as the KCONFIG variable.
Control file
============