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 3FBB9138331 for ; Sun, 18 Feb 2018 13:36:22 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7FA51E0C87; Sun, 18 Feb 2018 13:36:21 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.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 4D865E0C44 for ; Sun, 18 Feb 2018 13:36:21 +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 4A888335C4C for ; Sun, 18 Feb 2018 13:36:20 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id B939721D for ; Sun, 18 Feb 2018 13:36:18 +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: <1518960954.31b270ea4638bd18917a80c5615f1082ad91dd9c.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-7 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: eapi-differences.tex ebuild-env-vars.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 31b270ea4638bd18917a80c5615f1082ad91dd9c X-VCS-Branch: eapi-7 Date: Sun, 18 Feb 2018 13:36:18 +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: 02b776b9-96fb-4738-b9bc-17d8b2a2a917 X-Archives-Hash: e93ba2c4d694fab92efd2d42a380be6e commit: 31b270ea4638bd18917a80c5615f1082ad91dd9c Author: Michał Górny gentoo org> AuthorDate: Thu Sep 28 16:20:11 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sun Feb 18 13:35:54 2018 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=31b270ea EAPI 7 no longer adds trailing slash to ROOT, EROOT, D, ED. Bug: https://bugs.gentoo.org/465772 eapi-differences.tex | 5 +++++ ebuild-env-vars.tex | 58 ++++++++++++++++++++++++++++++++++++++++++---------- 2 files changed, 52 insertions(+), 11 deletions(-) diff --git a/eapi-differences.tex b/eapi-differences.tex index 283891b..21411eb 100644 --- a/eapi-differences.tex +++ b/eapi-differences.tex @@ -185,6 +185,9 @@ Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} & \t{EPREFIX}, \t{ED}, \t{EROOT} & \compactfeatureref{offset-prefix-vars} & * & Yes & Yes & Yes & Yes \\ +Trailing slash in \t{D} etc. & \compactfeatureref{trailing-slash} & + Yes & Yes & Yes & Yes & No \\ + \t{find} is GNU? & \compactfeatureref{gnu-find} & Undefined & Undefined & Yes & Yes & Yes \\ @@ -417,6 +420,8 @@ EAPI 7 is EAPI 6 with the following changes: \item \t{ECLASSDIR} is gone, \featureref{eclassdir}. \item \t{DESTTREE} is gone, \featureref{desttree}. \item \t{INSDESTTREE} is gone, \featureref{insdesttree}. +\item \t{ROOT}, \t{EROOT}, \t{D}, \t{ED} no longer end with a trailing slash, + \featureref{trailing-slash}. \end{compactitem} \ChangeWhenAddingAnEAPI{7} diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex index 2d79f20..27417bf 100644 --- a/ebuild-env-vars.tex +++ b/ebuild-env-vars.tex @@ -123,14 +123,15 @@ variable. The absolute path to the root directory into which the package is to be merged. Phases which run with full filesystem access must not touch any files outside of the directory given in \t{ROOT}\@. Also of note is that in a cross-compiling environment, binaries inside of \t{ROOT} - will not be executable on the build machine, so ebuilds must not call them. \t{ROOT} must be - non-empty and end in a trailing slash. \\ + will not be executable on the build machine, so ebuilds must not call them. The presence of + a trailing slash is EAPI dependent as listed in table~\ref{tab:trailing-slash}. \\ \t{EROOT} & \t{pkg_*} & No & - Contains the path \t{\$\{ROOT\%/\}\$\{EPREFIX\}/} for convenience. See also the - \t{EPREFIX} variable. Only for EAPIs listed in table~\ref{tab:offset-env-vars-table} as - supporting \t{EROOT}. \\ + Contains the concatenation of the paths in the \t{ROOT} and \t{EPREFIX} variables, + for convenience. See also the \t{EPREFIX} variable. Only for EAPIs listed in + table~\ref{tab:offset-env-vars-table} as supporting \t{EROOT}\@. The presence of a trailing + slash is 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 @@ -161,18 +162,21 @@ variable. \t{src_install} & No & Contains the full path to the image directory into which the package should be installed. - Must be non-empty and end in a trailing slash. \\ + The presence of a trailing slash is EAPI dependent as listed in table~\ref{tab:trailing-slash}. + \\ \t{D} (continued) & \t{pkg_preinst}, \t{pkg_postinst} & Yes & - Contains the full path to the image that is about to be or has just been merged. Must be - non-empty and end in a trailing slash. \\ + Contains the full path to the image that is about to be or has just been merged. + The presence of a trailing slash is EAPI dependent as listed in table~\ref{tab:trailing-slash}. + \\ \t{ED} & \t{src_install}, \t{pkg_preinst}, \t{pkg_postinst} & See \t{D} & - Contains the path \t{\$\{D\%/\}\$\{EPREFIX\}/} for convenience. See also the - \t{EPREFIX} variable. Only for EAPIs listed in table~\ref{tab:offset-env-vars-table} as - supporting \t{ED}. \\ + Contains the concatenation of the paths in the \t{D} and \t{EPREFIX} variables, + for convenience. See also the \t{EPREFIX} variable. Only for EAPIs listed in + table~\ref{tab:offset-env-vars-table} as supporting \t{ED}\@. The presence of a trailing slash + is EAPI dependent as listed in table~\ref{tab:trailing-slash}. \\ \t{DESTTREE} & \t{src_install} & No & @@ -433,6 +437,38 @@ behaviour of offset-prefix aware and agnostic is the same when \t{EPREFIX} is se string in offset-prefix aware EAPIs. The latter do have the variables \t{ED} and \t{EROOT} properly set, though. +\subsection{Path variables and trailing slash} +\label{sec:trailing-slash} + +Unless specified otherwise, the paths provided through package manager variables do not end with +a trailing slash and cannot be empty. A few exceptions to that rule are listed +in table~\ref{tab:trailing-slash} along with applicable EAPIs. + +For EAPIs where those variables are defined to always end with a trailing slash, the package manager +guarantees that a trailing slash will always be appended to the path in question. If the path +specifies the system root directory, it will consist of a single slash (\t{/}). + +\featurelabel{trailing-slash} For EAPIs where those variables are defined to never end with +a trailing slash, the package manager guarantees that a trailing slash will never be present. +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}{lll} + \toprule + \multicolumn{1}{c}{\textbf{EAPI}} & + \multicolumn{2}{c}{\textbf{Ends with a trailing slash?}} \\ + & + \t{ROOT}, \t{EROOT} & + \t{D}, \t{ED} \\ + \midrule + 0, 1, 2, 3, 4, 5, 6 & always & always \\ + 7 & never & never \\ + \bottomrule + \end{tabular} +\end{centertable} + % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : %%% Local Variables: