From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 0F903158086 for ; Tue, 19 Oct 2021 09:27:20 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 43696E0817; Tue, 19 Oct 2021 09:27:19 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-CHACHA20-POLY1305 (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id F3363E0817 for ; Tue, 19 Oct 2021 09:27:18 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-CHACHA20-POLY1305 (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 4D88833FEDE for ; Tue, 19 Oct 2021 09:27:17 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id B2325101 for ; Tue, 19 Oct 2021 09:27:15 +0000 (UTC) From: "Mike Frysinger" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Mike Frysinger" Message-ID: <1634635634.e20a78631323ed533041a23d0cb1f91e5f301713.vapier@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/dependencies/ X-VCS-Repository: proj/devmanual X-VCS-Files: general-concepts/dependencies/text.xml X-VCS-Directories: general-concepts/dependencies/ X-VCS-Committer: vapier X-VCS-Committer-Name: Mike Frysinger X-VCS-Revision: e20a78631323ed533041a23d0cb1f91e5f301713 X-VCS-Branch: master Date: Tue, 19 Oct 2021 09:27:15 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 2ed1582f-ba18-4b62-b4da-c2474e28796f X-Archives-Hash: 06f4b7505236293f8c27bc4d983908bb commit: e20a78631323ed533041a23d0cb1f91e5f301713 Author: Mike Frysinger gentoo org> AuthorDate: Tue Oct 19 09:17:19 2021 +0000 Commit: Mike Frysinger gentoo 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 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.

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).

CBUILD
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.
CHOST
@@ -53,8 +53,15 @@ systems when cross-compiling:

-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. +

+ +

+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.