From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-pms+bounces-1019-garchives=archives.gentoo.org@lists.gentoo.org>
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 18F521396D0
	for <garchives@archives.gentoo.org>; Wed,  4 Oct 2017 20:47:48 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 7BD69E0D91;
	Wed,  4 Oct 2017 20:47:47 +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 4F7ADE0D90
	for <gentoo-pms@lists.gentoo.org>; Wed,  4 Oct 2017 20:47:47 +0000 (UTC)
Received: from localhost.localdomain (d202-252.icpnet.pl [109.173.202.252])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(No client certificate requested)
	(Authenticated sender: mgorny)
	by smtp.gentoo.org (Postfix) with ESMTPSA id C12C73417CD;
	Wed,  4 Oct 2017 20:47:45 +0000 (UTC)
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@gentoo.org>
To: gentoo-pms@lists.gentoo.org
Cc: James Le Cuirot <chewi@gentoo.org>
Subject: [gentoo-pms] [PATCH 14/28] EAPI 7 has BROOT
Date: Wed,  4 Oct 2017 22:46:58 +0200
Message-Id: <20171004204712.10391-15-mgorny@gentoo.org>
X-Mailer: git-send-email 2.14.2
In-Reply-To: <20171004204712.10391-1-mgorny@gentoo.org>
References: <20171004204712.10391-1-mgorny@gentoo.org>
Precedence: bulk
List-Post: <mailto:gentoo-pms@lists.gentoo.org>
List-Help: <mailto:gentoo-pms+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-pms+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-pms+subscribe@lists.gentoo.org>
List-Id: Gentoo Package Manager Specification discussions <gentoo-pms.gentoo.org>
X-BeenThere: gentoo-pms@gentoo.org
X-BeenThere: gentoo-pms@lists.gentoo.org
Reply-To: gentoo-pms@lists.gentoo.org
X-Archives-Salt: f643d2b3-0256-48fc-851b-ff30a30d1fc2
X-Archives-Hash: 8edc812f37b6800e124b5edbd27bd8fa

From: James Le Cuirot <chewi@gentoo.org>

Bug: https://bugs.gentoo.org/317337
---
 eapi-differences.tex |  4 ++++
 ebuild-env-vars.tex  | 33 +++++++++++++++++++++------------
 2 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 9205125..af28b7a 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -41,6 +41,9 @@ of this document for a complete table of previous EAPIs.
 \bottomrule
 \endlastfoot
 
+\t{BROOT} & \compactfeatureref{broot} &
+    No & No & No & No & Yes \\
+
 \t{BDEPEND} & \compactfeatureref{bdepend} &
     No & No & No & No & Yes \\
 
@@ -413,6 +416,7 @@ EAPI 7 is EAPI 6 with the following changes:
 \item \t{SYSROOT} and \t{ESYSROOT} added, \featureref{sysroot}.
 \item \t{econf} adds \t{-{}-with-sysroot}, \featureref{econf-options}.
 \item \t{BDEPEND}, \featureref{bdepend}.
+\item \t{BROOT}, \featureref{broot}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{7}
diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
index e24a065..e91f36e 100644
--- a/ebuild-env-vars.tex
+++ b/ebuild-env-vars.tex
@@ -144,6 +144,13 @@ variable.
     for convenience.  See also the \t{EPREFIX} variable. Only for EAPIs listed
     in table~\ref{tab:offset-env-vars-table} as supporting \t{ESYSROOT}. The presence of a trailing
     slash EAPI-dependent as listed in table~\ref{tab:trailing-slash}. \\
+\t{BROOT} &
+    \t{src_*} &
+    No &
+    \featurelabel{broot} The absolute path to the root directory containing build dependencies
+    satisfied by BDEPEND, typically executable build tools. This includes any applicable offset
+    prefix. Only for EAPIs listed in table~\ref{tab:offset-env-vars-table} as supporting \t{BROOT}.
+    The presence of a trailing slash EAPI-dependent as listed in table~\ref{tab:trailing-slash}. \\
 \t{T} &
     All &
     Partially\footnote{Consistent and preserved across a single connected sequence of install or
@@ -253,19 +260,20 @@ variable.
 \ChangeWhenAddingAnEAPI{7}
 \begin{centertable}{EAPIs supporting various added env variables}
     \label{tab:added-env-vars-table}
-    \begin{tabular}{llllll}
+    \begin{tabular}{lllllll}
       \toprule
       \multicolumn{1}{c}{\textbf{EAPI}} &
       \multicolumn{1}{c}{\textbf{\t{MERGE_TYPE}?}} &
       \multicolumn{1}{P{6em}}{\textbf{\t{REPLACING_VERSIONS}?}} &
       \multicolumn{1}{P{6em}}{\textbf{\t{REPLACED_BY_VERSION}?}} &
       \multicolumn{1}{P{6em}}{\textbf{\t{EBUILD_PHASE_FUNC}?}} &
-      \multicolumn{1}{P{6em}}{\textbf{\t{SYSROOT}?}} \\
+      \multicolumn{1}{P{6em}}{\textbf{\t{SYSROOT}?}} &
+      \multicolumn{1}{P{6em}}{\textbf{\t{BROOT}?}} \\
       \midrule
-      0, 1, 2, 3        & No  & No  & No  & No  & No  \\
-      4                 & Yes & Yes & Yes & No  & No  \\
-      5, 6              & Yes & Yes & Yes & Yes & No  \\
-      7                 & Yes & Yes & Yes & Yes & Yes \\
+      0, 1, 2, 3        & No  & No  & No  & No  & No  & No  \\
+      4                 & Yes & Yes & Yes & No  & No  & No  \\
+      5, 6              & Yes & Yes & Yes & Yes & No  & No  \\
+      7                 & Yes & Yes & Yes & Yes & Yes & Yes \\
       \bottomrule
     \end{tabular}
 \end{centertable}
@@ -288,7 +296,7 @@ variable.
 \ChangeWhenAddingAnEAPI{7}
 \begin{centertable}{EAPIs supporting offset-prefix env variables}
     \label{tab:offset-env-vars-table}
-    \begin{tabular}{lllll}
+    \begin{tabular}{llllll}
       \toprule
       \multicolumn{1}{c}{\textbf{EAPI}} &
       \multicolumn{1}{c}{\textbf{\t{EPREFIX}?}} &
@@ -460,17 +468,18 @@ If the path specifies the system root directory, it will be empty.
 \ChangeWhenAddingAnEAPI{7}
 \begin{centertable}{Variables that always or never end with a trailing slash}
     \label{tab:trailing-slash}
-    \begin{tabular}{llll}
+    \begin{tabular}{lllll}
       \toprule
       \multicolumn{1}{c}{\textbf{EAPI}} &
-      \multicolumn{3}{c}{\textbf{Ends with a trailing slash?}} \\
+      \multicolumn{4}{c}{\textbf{Ends with a trailing slash?}} \\
       &
       \t{ROOT}, \t{EROOT} &
       \t{D}, \t{ED} &
-      \t{SYSROOT}, \t{ESYSROOT} \\
+      \t{SYSROOT}, \t{ESYSROOT} &
+      \t{BROOT} \\
       \midrule
-      0, 1, 2, 3, 4, 5, 6 & always & always & n/a    \\
-      7                   & never  & never  & never  \\
+      0, 1, 2, 3, 4, 5, 6 & always & always & n/a    & n/a    \\
+      7                   & never  & never  & never  & never  \\
       \bottomrule
     \end{tabular}
 \end{centertable}
-- 
2.14.2