[gentoo-commits] proj/pms:eapi-5 commit in: /

["Ulrich Mueller" <ulm@gentoo.org>]

commit:     1a3cff4237a0ee08f445e7b7fa9d0b5d5d3f2d7a
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun May 13 07:52:05 2012 +0000
Commit:     Ulrich Mueller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun May 13 07:52:05 2012 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=1a3cff42

src_test supports parallel tests in EAPI 5.

---
 eapi-differences.tex |    4 ++++
 ebuild-functions.tex |   24 ++++++++++++++++++++++--
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index d4c4611..2b2ae80 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -94,6 +94,9 @@ Use dependencies & \compactfeatureref{use-deps} &
 \t{src\_compile} style & \compactfeatureref{src-compile} &
     0 & 1 & 2 & 2 & 2 & 2 \\
 
+Parallel tests & \compactfeatureref{parallel-tests} &
+    No & No & No & No & No & Yes \\
+
 \t{src\_install} style & \compactfeatureref{src-install} &
     no-op & no-op & no-op & no-op & 4 & 4 \\
 
@@ -268,6 +271,7 @@ EAPI 5 is EAPI 4 with the following changes:
 \begin{compactitem}
 \item \t{econf} adds \t{-{}-disable-silent-rules}, \featureref{econf-options}.
 \item Slot operator dependencies, \featureref{slot-operator-deps}.
+\item \t{src\_test} supports parallel tests, \featureref{parallel-tests}.
 \item \t{USE} is calculated differently, \featureref{profile-iuse-injection}.
 \item \t{IMAGE} is gone, \featureref{image}.
 \item \t{REQUIRED\_USE} now supports \t{??} groups, \featureref{at-most-one-of}.

diff --git a/ebuild-functions.tex b/ebuild-functions.tex
index 318a732..9836e33 100644
--- a/ebuild-functions.tex
+++ b/ebuild-functions.tex
@@ -273,13 +273,33 @@ provided.
 
 The initial working directory must be \t{S} if that exists, falling back to \t{WORKDIR} otherwise.
 The default implementation used when the ebuild lacks the \t{src\_test} function must, if tests are
-enabled, run \t{emake -j1 check} if and only if such a target is available, or if not run
-\t{emake -j1 test} if and only if such a target is available. In both cases, if \t{emake} returns
+enabled, run \t{emake check} if and only if such a target is available, or if not run
+\t{emake test} if and only if such a target is available. In both cases, if \t{emake} returns
 non-zero the build must be aborted.
 
+\featurelabel{parallel-tests} For EAPIs listed in table~\ref{tab:src-test-table} as not supporting
+parallel tests, the \t{emake} command must be called with option \t{-j1}.
+
 The \t{src\_test} function may be disabled by \t{RESTRICT}. See section~\ref{sec:restrict}. It may
 be disabled by user too, using a PM-specific mechanism.
 
+\ChangeWhenAddingAnEAPI{5}
+\begin{centertable}{\t{src\_test} behaviour for EAPIs} \label{tab:src-test-table}
+    \begin{tabular}{ l l }
+        \toprule
+        \multicolumn{1}{c}{\textbf{EAPI}} &
+        \multicolumn{1}{c}{\textbf{Supports parallel tests?}} \\
+        \midrule
+    \t{0} & No \\
+    \t{1} & No \\
+    \t{2} & No \\
+    \t{3} & No \\
+    \t{4} & No \\
+    \t{5} & Yes \\
+    \bottomrule
+    \end{tabular}
+\end{centertable}
+
 \subsection{src\_install}
 \label{sec:src-install-function}