summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--eapi-differences.tex5
-rw-r--r--pkg-mgr-commands.tex24
2 files changed, 28 insertions, 1 deletions
diff --git a/eapi-differences.tex b/eapi-differences.tex
index 876eec0..aeafb49 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -151,6 +151,9 @@ Most utilities die & \compactfeatureref{die-on-failure} &
\t{dosed} & \compactfeatureref{banned-commands} &
Yes & Yes & Yes & Yes & Banned & Banned \\
+Option \t{-{}-host-root} & \compactfeatureref{host-root-option} &
+ No & No & No & No & No & Yes \\
+
\t{econf} arguments & \compactfeatureref{econf-options} &
& & & & disable dependency tracking & disable dependency tracking, disable silent rules \\
@@ -278,6 +281,8 @@ EAPI 5 is EAPI 4 with the following changes:
\item \t{EBUILD\_PHASE\_FUNC}, \featureref{ebuild-phase-func}.
\item \t{USE} is calculated differently, \featureref{profile-iuse-injection}.
\item \t{find} is guaranteed to be GNU, \featureref{gnu-find}.
+\item \t{best\_version} and \t{has\_version} support the \t{-{}-host-root} option,
+ \featureref{host-root-option}.
\item \t{econf} adds \t{-{}-disable-silent-rules}, \featureref{econf-options}.
\item \t{new*} can read from standard input, \featureref{newfoo-stdin}.
\end{compactitem}
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 0818719..f99f30c 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -79,9 +79,13 @@ argument. Ebuilds must not run any of these commands once the current phase func
\end{description}
\subsubsection{Package manager query commands}
-These commands are used to extract information about the host system. Ebuilds must not run any of
+These commands are used to extract information about the system. Ebuilds must not run any of
these commands in parallel with any other package manager command. Ebuilds must not run any of
these commands once the current phase function has returned.
+
+\featurelabel{host-root-option} In EAPIs listed in table~\ref{tab:foo-version-host-root-table} as
+supporting option \t{-{}-host-root}, this flag as the first argument will cause the query to apply
+to the host root instead of \t{ROOT}.
\begin{description}
\item[has\_version] Takes exactly one package dependency specification as an argument. Returns
true if a package matching the atom is installed in \t{ROOT}, and false otherwise.
@@ -491,6 +495,24 @@ that can be passed to \t{dohtml} are as follows:
\end{tabular}
\end{centertable}
+\ChangeWhenAddingAnEAPI{5}
+\begin{centertable}{EAPIs supporting \t{-{}-host-root} for \t{*\_version} commands}
+ \label{tab:foo-version-host-root-table}
+ \begin{tabular}{ l l }
+ \toprule
+ \multicolumn{1}{c}{\textbf{EAPI}} &
+ \multicolumn{1}{c}{\textbf{\t{*\_version} supports \t{-{}-host-root}?}} \\
+ \midrule
+ \t{0} & No \\
+ \t{1} & No \\
+ \t{2} & No \\
+ \t{3} & No \\
+ \t{4} & No \\
+ \t{5} & Yes \\
+ \bottomrule
+ \end{tabular}
+\end{centertable}
+
\subsubsection{Commands affecting install destinations}
The following commands are used to set the various destination trees, all relative to \t{\$\{ED\}} in
offset-prefix aware EAPIs and relative to \t{\$\{D\}} in offset-prefix agnostic EAPIs, used by the