Make sure we only build one package config per interactive tennant

1 files changed, 13 insertions, 0 deletions

diff --git a/doc/manual.cli b/doc/manual.cli
index d0a1923..53dcb28 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -359,8 +359,21 @@ being applied. Currently, only the following value groups can be overridden:
 \
 build-email build-{warning,error}-email
 builds build-{include,exclude}
+*-builds *-build-{include,exclude}
 \
 
+Note that the build constraints group values (both common and build package
+configuration-specific) are overridden hierarchically so that the
+\c{[\b{*-}]\b{build-}{\b{include},\b{exclude}\}} overrides don't affect the
+respective \c{[\b{*-}]\b{builds}} values.
+
+Note also that the common and build package configuration-specific build
+constraints group value overrides are mutually exclusive. If the common build
+constraints are overridden, then all the configuration-specific constraints
+are removed. Otherwise, if any configuration-specific constraints are
+overridden, then for the remaining configurations the build constraints are
+reset to \cb{builds:\ none}.
+
 See \l{bpkg#manifest-package Package Manifest} for details on these values.