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 9CEF81396D1 for ; Mon, 25 Sep 2017 04:31:08 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id DFFDFE0F3B; Mon, 25 Sep 2017 04:31:07 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (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 B87F3E0F3B for ; Mon, 25 Sep 2017 04:31:07 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 EF84F340806 for ; Mon, 25 Sep 2017 04:31:06 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 44D54908F for ; Mon, 25 Sep 2017 04:31:05 +0000 (UTC) From: "Göktürk Yüksek" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Göktürk Yüksek" Message-ID: <1506313761.d82fac36796849882d8718bdb024f7d01daed50a.gokturk@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: gokturk X-VCS-Committer-Name: Göktürk Yüksek X-VCS-Revision: d82fac36796849882d8718bdb024f7d01daed50a X-VCS-Branch: master Date: Mon, 25 Sep 2017 04:31:05 +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-Archives-Salt: ff6fe417-0e36-4f36-b54c-743cddb455ba X-Archives-Hash: 03057dfba18998320c94c917be9dd609 commit: d82fac36796849882d8718bdb024f7d01daed50a Author: Michał Górny gentoo org> AuthorDate: Wed Sep 6 10:11:16 2017 +0000 Commit: Göktürk Yüksek gentoo org> CommitDate: Mon Sep 25 04:29:21 2017 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d82fac36 general-concepts/dependencies: Add a warning on pure DEPEND soft blockers general-concepts/dependencies/text.xml | 20 +++++++++++++------- 1 file 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.

+The following description applies to all EAPIs starting with EAPI 2. +

+ +

There are two kinds of blockers: soft blockers and hard blockers.

@@ -233,11 +237,17 @@ to solve file collisions between packages and are meaningful only in RDEPEND.

+ +Soft blockers that are pure DEPEND do not work correctly. +While Portage seemingly queues the package for removal, it does not +exempt their contents from file collision checks. Always include your +soft blockers in RDEPEND! + +

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:

@@ -254,10 +264,6 @@ or when it is installed from a binary package.

-Hard blocks require EAPI 2 or newer. -

- -

Specific versions can also be blocked: