1 |
Bug: https://bugs.gentoo.org/482884 |
2 |
--- |
3 |
eapi-differences.tex | 4 ++++ |
4 |
pkg-mgr-commands.tex | 18 ++++++++++++++++++ |
5 |
2 files changed, 22 insertions(+) |
6 |
|
7 |
diff --git a/eapi-differences.tex b/eapi-differences.tex |
8 |
index a56f1ff..34ee0c9 100644 |
9 |
--- a/eapi-differences.tex |
10 |
+++ b/eapi-differences.tex |
11 |
@@ -41,6 +41,9 @@ of this document for a complete table of previous EAPIs. |
12 |
\bottomrule |
13 |
\endlastfoot |
14 |
|
15 |
+\t{eqawarn} & \compactfeatureref{eqawarn} & |
16 |
+ No & No & No & No & Yes \\ |
17 |
+ |
18 |
\t{ver_*} functions & \compactfeatureref{ver-functions} & |
19 |
No & No & No & No & Yes \\ |
20 |
|
21 |
@@ -387,6 +390,7 @@ EAPI 7 is EAPI 6 with the following changes: |
22 |
directories, \featureref{profile-file-dirs}. |
23 |
\item \t{dohtml} banned, \featureref{banned-commands}. |
24 |
\item Version manipulation and comparison functions added, \featureref{ver-functions}. |
25 |
+\item \t{eqawarn} added, \featureref{eqawarn}. |
26 |
\end{compactitem} |
27 |
|
28 |
\ChangeWhenAddingAnEAPI{7} |
29 |
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex |
30 |
index 15bfcde..c7f3696 100644 |
31 |
--- a/pkg-mgr-commands.tex |
32 |
+++ b/pkg-mgr-commands.tex |
33 |
@@ -124,6 +124,10 @@ stderr or some other appropriate facility. |
34 |
example. |
35 |
\item[ewarn] Displays a warning message. Must not go to stdout. |
36 |
\item[eerror] Displays an error message. Must not go to stdout. |
37 |
+\item[eqawarn] \featurelabel{eqawarn} Display a QA warning message intended for ebuild developers. |
38 |
+ The package manager may provide appropriate mechanisms to skip those messages for normal users. |
39 |
+ Must not go to stdout. Only available in EAPIs listed in table~\ref{tab:output-commands} as |
40 |
+ supporting \t{eqawarn}. |
41 |
\item[ebegin] Displays an informational message. Should be used when beginning a possibly |
42 |
lengthy process, and followed by a call to \t{eend}. |
43 |
\item[eend] Indicates that the process begun with an \t{ebegin} message has completed. Takes one |
44 |
@@ -132,6 +136,20 @@ stderr or some other appropriate facility. |
45 |
message followed by a failure indicator. Returns its first argument as exit status. |
46 |
\end{description} |
47 |
|
48 |
+\ChangeWhenAddingAnEAPI{7} |
49 |
+\begin{centertable}{Output commands for EAPIs} |
50 |
+ \label{tab:output-commands} |
51 |
+ \begin{tabular}{ll} |
52 |
+ \toprule |
53 |
+ \multicolumn{1}{c}{\textbf{EAPI}} & |
54 |
+ \multicolumn{1}{c}{\textbf{\t{eqawarn}?}} \\ |
55 |
+ \midrule |
56 |
+ 0, 1, 2, 3, 4, 5, 6 & No \\ |
57 |
+ 7 & Yes \\ |
58 |
+ \bottomrule |
59 |
+ \end{tabular} |
60 |
+\end{centertable} |
61 |
+ |
62 |
\subsubsection{Error commands} |
63 |
These commands are used when an error is detected that will prevent the build process from |
64 |
completing. Ebuilds must not run any of these commands once the current phase function has returned. |
65 |
-- |
66 |
2.14.2 |