poky/documentation/dev-manual
Antonin Godard adc323dd4d dev-manual: document how to provide confs from layer.conf
Add a section on providing global level configuration from the
layer.conf file. Since this file is parsed at an earlier stage in the
parsing process, it's not possible to combine bb.utils.contains and
{DISTRO,MACHINE}_FEATURES to conditionally set some configurations.

This patch documents:

- First that this file can be used for providing such configuration.
- Then demonstrate how to conditionally provide them, using a technique
  that is currently used in meta-virtualization
  (https://git.yoctoproject.org/meta-virtualization/tree/conf/layer.conf#n50).

Fixes [YOCTO #12688].

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: cc3fa1b0e51377f4e03eaa1ca60c2f2ee0cd917e)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2024-11-15 11:16:58 +00:00
..
figures dev-manual: improve screenshot resolution 2022-06-30 17:09:51 +01:00
bblock.rst dev-manual: add bblock documentation 2024-11-07 10:12:24 +00:00
bmaptool.rst dev-manual: bmaptool: rename 2024-03-06 16:54:54 +00:00
build-quality.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
building.rst dev-manual: improve descriptions of 'bitbake -S printdiff' 2024-03-19 15:22:27 +00:00
custom-distribution.rst dev-manual: update custom distribution section 2024-04-16 07:55:42 +01:00
custom-template-configuration-directory.rst dev/ref-manual: document conf-summary.txt together with conf-notes.txt 2024-03-19 15:22:27 +00:00
customizing-images.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00
debugging.rst dev-manual/debugging: mention new `taskexp_ncurses` option 2024-04-12 17:29:34 +01:00
development-shell.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
device-manager.rst manuals: document VIRTUAL-RUNTIME variables 2024-03-06 16:54:54 +00:00
disk-space.rst dev-manual: update reference to sstate-cache-management script 2024-04-16 07:55:42 +01:00
efficiently-fetching-sources.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00
error-reporting-tool.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
external-scm.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00
external-toolchain.rst manual: improve documentation about using external toolchains 2022-12-18 10:41:21 +00:00
gobject-introspection.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
index.rst dev-manual: add bblock documentation 2024-11-07 10:12:24 +00:00
init-manager.rst manuals: fix trailing spaces 2024-04-08 14:36:38 +01:00
intro.rst dev-manual: various pedantic nitpickery 2021-09-04 08:46:35 +01:00
layers.rst dev-manual: document how to provide confs from layer.conf 2024-11-15 11:16:58 +00:00
libraries.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
licenses.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
new-machine.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
new-recipe.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
packages.rst dev-manual: packages: fix capitalization 2024-03-06 16:54:54 +00:00
prebuilt-libraries.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
python-development-shell.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
qemu.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
quilt.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
read-only-rootfs.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
runtime-testing.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
sbom.rst dev-manual: Rephrase spdx creation 2024-02-24 16:13:28 +00:00
securing-images.rst manuals: add "LTS" term 2023-04-03 14:48:47 +01:00
security-subjects.rst dev-manual: add security team processes 2023-10-30 11:11:16 +00:00
speeding-up-build.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
start.rst dev-manual: Add info on build env initialization 2024-06-16 22:48:18 +01:00
temporary-source-code.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00
upgrading-recipes.rst dev-manual: fix testimage usage instructions 2023-10-09 15:52:17 +01:00
vulnerabilities.rst manuals: document NVDCVE_API_KEY variable 2024-05-29 20:58:49 +01:00
wayland.rst manuals: define proper numbered lists 2022-12-18 10:41:21 +00:00
wic.rst manuals: remove tab characters 2024-04-12 17:29:34 +01:00
x32-psabi.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00