From b8a4fbc237c513da28f6df5eb6443d63ee9c2275 Mon Sep 17 00:00:00 2001 From: Grzegorz Bokota Date: Sun, 21 Sep 2025 11:23:45 +0200 Subject: [PATCH] Improve information about configuration overriding (#2598) * Improve information about configuration overriding * remove obsolete " * Update docs/configuration.md Co-authored-by: Joe Rickerby --------- Co-authored-by: Joe Rickerby --- docs/configuration.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/configuration.md b/docs/configuration.md index b37d785f..1e83708c 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -112,7 +112,8 @@ The complete set of defaults for the current version of cibuildwheel are shown b One feature specific to the configuration files is the ability to override settings based on selectors. To use, add a ``tool.cibuildwheel.overrides`` -array, and specify a ``select`` string. Then any options you set will only +array, and specify a ``select`` string, referencing the [build identifier](options.md#build-skip) (not wheel name!). +Then any options you set will only apply to items that match that selector. These are applied in order, with later matches overriding earlier ones if multiple selectors match. Environment variables always override static configuration. @@ -120,9 +121,11 @@ variables always override static configuration. A few of the options below have special handling in overrides. A different `before-all` will trigger a new container to launch on Linux, and cannot be overridden on macOS or Windows. Overriding the image on linux will also -trigger new containers, one per image. Some commands are not supported; -`output-dir`, build/skip/test_skip selectors, and architectures cannot be -overridden. +trigger new containers, one per image. + +!!! note "Some commands are not supported" + + The ``output-dir``, ``build``, ``skip``, ``test_skip`` selectors, and architectures cannot be overridden. You can specify a table of overrides in `inherit={}`, any list or table in this list will inherit from previous overrides or the main configuration. The valid