From b4a51d8939f8007ebd849243dba16d417c74c38e Mon Sep 17 00:00:00 2001 From: Alice Frosi Date: Tue, 26 May 2020 16:36:36 +0200 Subject: [PATCH] docs: add fragment exclusion tag Document how to use the !arch tag added by #1042 Fixes: #1010 Signed-off-by: Alice Frosi --- kernel/configs/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/kernel/configs/README.md b/kernel/configs/README.md index 7e9a5e668c..e664095b44 100644 --- a/kernel/configs/README.md +++ b/kernel/configs/README.md @@ -55,6 +55,12 @@ into a fragment. If adding config entries for a new subsystem or feature, consider making a new fragment with an appropriately descriptive name. +If you want to disable an entire fragment for a specific architecture, you can add the tag `# !${arch}` in the first line of the fragment. You can also exclude multiple architectures on the same line. Note the `#` at the beginning of the line, this is required to avoid that the tag is interpreted as a configuration. +Example of valid exclusion: +``` +# !s390x !ppc64le +``` + The fragment gathering tool perfoms some basic sanity checks, and the `build-kernel.sh` will fail and report the error in the cases of: