diff options
author | Mike Frysinger <vapier@gentoo.org> | 2021-10-19 05:17:19 -0400 |
---|---|---|
committer | Mike Frysinger <vapier@gentoo.org> | 2021-10-19 05:27:14 -0400 |
commit | e20a78631323ed533041a23d0cb1f91e5f301713 (patch) | |
tree | 6ca4512b0c22264dd49820ac25698316eecd1433 /general-concepts/dependencies/text.xml | |
parent | .github/workflows/devmanual-ci.yml: Run apt-get update (diff) | |
download | devmanual-e20a78631323ed533041a23d0cb1f91e5f301713.tar.gz devmanual-e20a78631323ed533041a23d0cb1f91e5f301713.tar.bz2 devmanual-e20a78631323ed533041a23d0cb1f91e5f301713.zip |
dependencies: clarify cross-compiling and system shorthands
Try and clarify that BDEPEND/DEPEND are split based on the install
targets, not only when the literal $CBUILD & $CHOST values differ,
and thus only when "cross-compiling" is used.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Diffstat (limited to 'general-concepts/dependencies/text.xml')
-rw-r--r-- | general-concepts/dependencies/text.xml | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 1340b1c..a3ea540 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -34,15 +34,15 @@ for how dependencies and revisions interact. <p> In order to avoid ambiguity, we use the following terms to indicate different -systems when cross-compiling: +systems when cross-compiling. They serve as a shorthand for an overall system +in addition to their literal value (e.g. $CHOST). </p> <dl> <dt>CBUILD</dt> <dd> The system on which the build is performed. Dependencies that apply - to the CBUILD system can be executed during build time. When - cross-compiling, they are not installed into the system being built. + to the CBUILD system can be executed during build time. </dd> <dt>CHOST</dt> @@ -53,8 +53,15 @@ systems when cross-compiling: </dl> <p> -When not cross-compiling, CBUILD and CHOST have the same value and both classes -of dependencies are merged. +When cross-compiling, CBUILD and CHOST are naturally different, as are the +actual install paths for the different types of dependencies. +</p> + +<p> +Note however that, while cross-compiling is used to help explain these concepts, +it is not strictly required. CBUILD and CHOST could target the exact same +hardware, but be installed into distinct SYSROOT/ROOT paths. The dependency +distinctions still apply even if it isn't, strictly speaking, cross-compiling. </p> </body> |