summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2012-05-10 06:56:50 (GMT)
committerUlrich Müller <ulm@gentoo.org>2012-09-13 06:28:16 (GMT)
commit1cf4f7dc805edabc03cd35cb743c3601c611295a (patch)
tree51f70f3f2d41c0db64f4e86cc10d73bfe92a8b11
parentEAPI 5 mandates GNU find (diff)
downloadpms-1cf4f7dc805edabc03cd35cb743c3601c611295a.zip
pms-1cf4f7dc805edabc03cd35cb743c3601c611295a.tar.gz
pms-1cf4f7dc805edabc03cd35cb743c3601c611295a.tar.bz2
EAPI 5: new* commands can read from standard input.
See bug 263565.
-rw-r--r--eapi-differences.tex4
-rw-r--r--pkg-mgr-commands.tex23
2 files changed, 25 insertions, 2 deletions
diff --git a/eapi-differences.tex b/eapi-differences.tex
index e302b84..40d3d5c 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -157,6 +157,9 @@ Most utilities die & \compactfeatureref{die-on-failure} &
\t{doman -i18n} precedence & \compactfeatureref{doman-langs} &
N/A & N/A & No & No & Yes & Yes \\
+\t{new*} support stdin & \compactfeatureref{newfoo-stdin} &
+ No & No & No & No & No & Yes \\
+
Controllable compression & \compactfeatureref{controllable-compress} &
No & No & No & No & Yes & Yes \\
@@ -263,6 +266,7 @@ EAPI 5 is EAPI 4 with the following changes:
\item \t{USE} is calculated differently, \featureref{profile-iuse-injection}.
\item \t{find} is guaranteed to be GNU, \featureref{gnu-find}.
\item \t{econf} adds \t{-{}-disable-silent-rules}, \featureref{econf-options}.
+\item \t{new*} can read from standard input, \featureref{newfoo-stdin}.
\end{compactitem}
\ChangeWhenAddingAnEAPI{5}
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index b26e15f..0818719 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -389,8 +389,10 @@ that can be passed to \t{dohtml} are as follows:
\item[fperms] Acts as for \t{chmod}, but takes paths relative to the image directory. Failure
behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}.
-\item[newbin] As for \t{dobin}, but takes two parameters. The first is the file to install; the
- second is the new filename under which it will be installed.
+\item[newbin] \featurelabel{newfoo-stdin} As for \t{dobin}, but takes two parameters. The first is
+ the file to install; the second is the new filename under which it will be installed. In EAPIs
+ specified by table~\ref{tab:newfoo-stdin-table}, standard input is read when the first
+ parameter is \t{-} (a hyphen). In this case, it is an error if standard input is a terminal.
\item[newconfd] As for \t{doconfd}, but takes two parameters as for \t{newbin}.
@@ -472,6 +474,23 @@ that can be passed to \t{dohtml} are as follows:
\end{tabular}
\end{centertable}
+\ChangeWhenAddingAnEAPI{5}
+\begin{centertable}{EAPIs supporting stdin for \t{new*} commands} \label{tab:newfoo-stdin-table}
+ \begin{tabular}{ l l }
+ \toprule
+ \multicolumn{1}{c}{\textbf{EAPI}} &
+ \multicolumn{1}{c}{\textbf{\t{new*} can read from stdin?}} \\
+ \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