commit: e20a78631323ed533041a23d0cb1f91e5f301713
Author: Mike Frysinger <vapier <AT> gentoo <DOT> org>
AuthorDate: Tue Oct 19 09:17:19 2021 +0000
Commit: Mike Frysinger <vapier <AT> gentoo <DOT> org>
CommitDate: Tue Oct 19 09:27:14 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e20a7863
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 <AT> gentoo.org>
general-concepts/dependencies/text.xml | 17 ++++++++++++-----
1 file 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>
