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.
