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 82D2B1382C5 for ; Mon, 25 May 2020 15:43:31 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A3E6DE0841; Mon, 25 May 2020 15:43:30 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 77707E083E for ; Mon, 25 May 2020 15:43:30 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 0686634EDE1 for ; Mon, 25 May 2020 15:43:29 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 7F05323E for ; Mon, 25 May 2020 15:43:27 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1589022379.be93eaeb521f18b0f8b563accd1d2b398bb87b02.ulm@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: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: be93eaeb521f18b0f8b563accd1d2b398bb87b02 X-VCS-Branch: master Date: Mon, 25 May 2020 15:43:27 +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: 99731bf7-8aae-4bfd-b410-b516547d6f12 X-Archives-Hash: 20929701a785273cc76e44c336257a1c commit: be93eaeb521f18b0f8b563accd1d2b398bb87b02 Author: Ulrich Müller gentoo org> AuthorDate: Wed Apr 15 18:23:47 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sat May 9 11:06:19 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=be93eaeb general-concepts/dependencies: Better section structure. Collect similar topics as subsections under new section headers. Signed-off-by: Ulrich Müller gentoo.org> general-concepts/dependencies/text.xml | 114 +++++++++++++++++---------------- 1 file changed, 60 insertions(+), 54 deletions(-) diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 1a1d970..52d053e 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -2,16 +2,19 @@ Dependencies -

Automatic dependency resolution is one of the most useful features provided by emerge.

+
+Dependency types + + CHOST vs CBUILD @@ -41,9 +44,9 @@ of dependencies are merged.

-
+ -
+ Build Dependencies @@ -67,9 +70,9 @@ In earlier EAPIs, all build dependencies are placed in DEPEND.

-
+ -
+ Runtime Dependencies @@ -91,9 +94,9 @@ Items which are in RDEPEND but not DEPEND could in theory b

-
+ -
+ Post Dependencies @@ -105,39 +108,13 @@ while in general case RDEPEND should be used instead.

+
-Implicit System Dependency - +Dependency Syntax -

-All packages have an implicit compile-time and runtime dependency upon the -entire @system set. It is therefore not necessary, nor -advisable, to -specify dependencies upon toolchain packages like gcc, libc and -so on, except where specific versions or packages (for example, glibc -over uclibc) are required. Note that this rule also needs consideration -for packages like flex, zlib and libtool, which aren't in -the @system set for every profile. For example, the embedded -profile doesn't have zlib in @system, the libtool -ABI might -change and break building order and flex might get removed from the -@system set in future. -

- -

-However, packages which are included in the @system set, or are -dependencies of @system set packages, should generally include -a complete dependency list (excluding bootstrap packages). This makes -emerge -e @system -possible when installing from a stage 1 or stage 2 tarball. -

- - -
- -
+ Basic Dependency Syntax @@ -159,9 +136,9 @@ When specifying names, the category part should be treated as mandatory.

-
+ -
+ Version Dependencies @@ -179,7 +156,7 @@ This states that at least version 0.9.7d of openssl is required.

- + Version Specifiers @@ -222,9 +199,9 @@ Available version specifiers are: - + - + Ranged Dependencies @@ -244,9 +221,9 @@ asterisk. Also note that when selecting all versions in a specific

-
+ - + Blockers @@ -343,10 +320,10 @@ newer package that caused the issues.

+
-
-
+ SLOT Dependencies @@ -370,7 +347,7 @@ DEPEND="qt3? ( ~x11-libs/qt-3.3.8:3 ) - + Slot Operators @@ -407,10 +384,10 @@ RDEPEND="media-libs/cogl:1.0= + -
-
+ USE-Conditional Dependencies @@ -464,9 +441,9 @@ DEPEND="!build? ( -
+ -
+ Any of Many Dependencies @@ -487,7 +464,7 @@ DEPEND="baz? ( || ( app-misc/foo app-misc/bar ) )" - + Any of Many Versus USE @@ -509,10 +486,10 @@ flag is not necessary if and only if all of the following hold: + -
-
+ Built with USE Dependencies @@ -567,7 +544,7 @@ There are also shortcuts for conditional situations: - + Use dependency defaults @@ -592,9 +569,38 @@ DEPEND=" +
+
+Implicit System Dependency + + +

+All packages have an implicit compile-time and runtime dependency upon the +entire @system set. It is therefore not necessary, nor advisable, to +specify dependencies upon toolchain packages like gcc, libc and +so on, except where specific versions or packages (for example, glibc +over uclibc) are required. Note that this rule also needs consideration +for packages like flex, zlib and libtool, which aren't in +the @system set for every profile. For example, the embedded profile +doesn't have zlib in @system, the libtool ABI might +change and break building order and flex might get removed from the +@system set in future. +

+ +

+However, packages which are included in the @system set, or are +dependencies of @system set packages, should generally include +a complete dependency list (excluding bootstrap packages). This makes +emerge -e @system possible when installing from a stage 1 or stage 2 +tarball. +

+ + +
+
Test Dependencies