diff options
author | Michał Górny <mgorny@gentoo.org> | 2017-09-06 12:11:16 +0200 |
---|---|---|
committer | Göktürk Yüksek <gokturk@gentoo.org> | 2017-09-25 00:29:21 -0400 |
commit | d82fac36796849882d8718bdb024f7d01daed50a (patch) | |
tree | c6c24d25013db1fcb53c38567d58c92b7f52e3a4 /general-concepts/dependencies/text.xml | |
parent | general-concepts/dependencies: Explain the meaning of hard blockers in DEP/RDEP (diff) | |
download | devmanual-d82fac36796849882d8718bdb024f7d01daed50a.tar.gz devmanual-d82fac36796849882d8718bdb024f7d01daed50a.tar.bz2 devmanual-d82fac36796849882d8718bdb024f7d01daed50a.zip |
general-concepts/dependencies: Add a warning on pure DEPEND soft blockers
Diffstat (limited to 'general-concepts/dependencies/text.xml')
-rw-r--r-- | general-concepts/dependencies/text.xml | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index f6cceba..7c8caeb 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -215,6 +215,10 @@ to the package manager. </p> <p> +The following description applies to all EAPIs starting with EAPI 2. +</p> + +<p> There are two kinds of blockers: soft blockers and hard blockers. </p> @@ -233,11 +237,17 @@ to solve file collisions between packages and are meaningful only in <c>RDEPEND</c>. </p> +<warning> +Soft blockers that are pure <c>DEPEND</c> <e>do not work correctly</e>. +While Portage seemingly queues the package for removal, it <e>does not</e> +exempt their contents from file collision checks. Always include your +soft blockers in <c>RDEPEND</c>! +</warning> + <p> If it is strictly necessary to resolve the blocker before the package -is built (installed) or if automatic resolution is undesired, -a hard blocker must be used instead. Hard blockers are not resolved -automatically, and are expressed using the following syntax: +is built (installed), a hard blocker must be used instead. Hard blockers +are expressed using the following syntax: </p> <codesample lang="ebuild"> @@ -254,10 +264,6 @@ or when it is installed from a binary package. </p> <p> -Hard blocks require EAPI 2 or newer. -</p> - -<p> Specific versions can also be blocked: </p> |