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

["Michał Górny" <mgorny@gentoo.org>]

commit:     e89a0495b1a774edfa1a6fe277e5485453e1b80d
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Thu Sep 28 14:05:38 2017 +0000
Commit:     Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Thu Sep 28 16:31:45 2017 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=e89a0495

EAPI 7 has eqawarn

Bug: https://bugs.gentoo.org/482884

 eapi-differences.tex |  4 ++++
 pkg-mgr-commands.tex | 18 ++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index a56f1ff..34ee0c9 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{eqawarn} & \compactfeatureref{eqawarn} &
+    No & No & No & No & Yes \\
+
 \t{ver_*} functions & \compactfeatureref{ver-functions} &
     No & No & No & No & Yes \\
 
@@ -387,6 +390,7 @@ EAPI 7 is EAPI 6 with the following changes:
     directories, \featureref{profile-file-dirs}.
 \item \t{dohtml} banned, \featureref{banned-commands}.
 \item Version manipulation and comparison functions added, \featureref{ver-functions}.
+\item \t{eqawarn} added, \featureref{eqawarn}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{7}

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 15bfcde..c7f3696 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -124,6 +124,10 @@ stderr or some other appropriate facility.
     example.
 \item[ewarn] Displays a warning message. Must not go to stdout.
 \item[eerror] Displays an error message. Must not go to stdout.
+\item[eqawarn] \featurelabel{eqawarn} Display a QA warning message intended for ebuild developers.
+    The package manager may provide appropriate mechanisms to skip those messages for normal users.
+    Must not go to stdout.  Only available in EAPIs listed in table~\ref{tab:output-commands} as
+    supporting \t{eqawarn}.
 \item[ebegin] Displays an informational message. Should be used when beginning a possibly
     lengthy process, and followed by a call to \t{eend}.
 \item[eend] Indicates that the process begun with an \t{ebegin} message has completed. Takes one
@@ -132,6 +136,20 @@ stderr or some other appropriate facility.
     message followed by a failure indicator. Returns its first argument as exit status.
 \end{description}
 
+\ChangeWhenAddingAnEAPI{7}
+\begin{centertable}{Output commands for EAPIs}
+    \label{tab:output-commands}
+    \begin{tabular}{ll}
+      \toprule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{1}{c}{\textbf{\t{eqawarn}?}} \\
+      \midrule
+      0, 1, 2, 3, 4, 5, 6  & No  \\
+      7                    & Yes \\
+      \bottomrule
+    \end{tabular}
+\end{centertable}
+
 \subsubsection{Error commands}
 These commands are used when an error is detected that will prevent the build process from
 completing. Ebuilds must not run any of these commands once the current phase function has returned.