commit: 48e3b8835ff3932aad95871276eb3fbe24d45847 Author: Michał Górny <mgorny <AT> gentoo <DOT> org> AuthorDate: Thu Sep 28 14:05:38 2017 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Mon Oct 9 17:12:08 2017 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=48e3b883
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 9f3f8be..8a1e55a 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 5b65477..91f38c0 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} + \subsection{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.
