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 | |
| 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')
| -rw-r--r-- | debian/README.source | 23 | ||||
| -rw-r--r-- | debian/changelog | 1 |
2 files changed, 24 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. diff --git a/debian/changelog b/debian/changelog index 9485c1b83f85..5fc21da078f4 100644 --- a/debian/changelog +++ b/debian/changelog @@ -5,6 +5,7 @@ linux (4.19.37-4) UNRELEASED; urgency=medium - libbpf: Use only 2 components in soversion, matching package name (Closes: #929187) - libbpf: Build out-of-tree + * README.source: Document the various makefiles and use of out-of-tree builds -- Ben Hutchings <ben@decadent.org.uk> Sun, 19 May 2019 00:04:16 +0100 |