diff options
author | Ben Hutchings <ben@decadent.org.uk> | 2019-05-19 15:05:10 +0100 |
---|---|---|
committer | Ben Hutchings <ben@decadent.org.uk> | 2019-05-19 15:05:10 +0100 |
commit | a8c3d89c718a7cb9eb08ad4ea571e887c687a670 (patch) | |
tree | e0e93b84fc7f3f6b5d3a189a30e4df664ef46cb1 /debian/README.source | |
parent | a96bd61a2eb2ed88f66cec1a7d57fc38c7d0db69 (diff) | |
download | kernel_replicant_linux-a8c3d89c718a7cb9eb08ad4ea571e887c687a670.tar.gz kernel_replicant_linux-a8c3d89c718a7cb9eb08ad4ea571e887c687a670.tar.bz2 kernel_replicant_linux-a8c3d89c718a7cb9eb08ad4ea571e887c687a670.zip |
README.source: Document the various makefiles and use of out-of-tree builds
Diffstat (limited to 'debian/README.source')
-rw-r--r-- | debian/README.source | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/debian/README.source b/debian/README.source index 123eea728cff..874311872b4b 100644 --- a/debian/README.source +++ b/debian/README.source @@ -253,3 +253,26 @@ Several build profiles are understood and supported: with nopython as the build-dependencies will be unsatisfiable otherwise. - nopython: Disable Python bindings. This currently disables building the linux-perf-<version> package, as the perf program embeds Python. + +Build rules +=========== + +The Debian build rules are split across multiple makefiles: + +- debian/rules: Standard top-level makefile for Debian package build. +- debian/rules.gen: Intermediate makefile between debian/rules and + debian/rules.real. This is generated by gencontrol.py based on + the configuration under debian/config. +- debian/rules.real: Makefile for building a single kernel flavour + or other group of binary packages. +- debian/rules.d: Makefiles for building userland code from specific + source directories. The directory structure mirrors the kernel + source directories. debian/rules.real uses the "make-tools" to + invoke these makefiles. + +All builds *must* be done out-of-tree in a subdirectory of +debian/build, so that the output files do not end up in the +linux-source-<version> binary package. Currently kernel builds use +debian/build/build_<arch>_<featureset>_<flavour>, userland code uses +debian/build/build-tools/<source-dir> and documentation uses +debian/build/build-doc. |