1 |
Bug: https://bugs.gentoo.org/806181 |
2 |
Signed-off-by: Ulrich Müller <ulm@g.o> |
3 |
--- |
4 |
eapi-differences.tex | 5 +++++ |
5 |
profiles.tex | 23 +++++++++++++++++++++-- |
6 |
2 files changed, 26 insertions(+), 2 deletions(-) |
7 |
|
8 |
diff --git a/eapi-differences.tex b/eapi-differences.tex |
9 |
index bb84b85..19f5134 100644 |
10 |
--- a/eapi-differences.tex |
11 |
+++ b/eapi-differences.tex |
12 |
@@ -50,6 +50,9 @@ Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} & |
13 |
Comments in profiles \t{parent} file & \compactfeatureref{parent-comments} & |
14 |
No & No & No & No & Yes \\ |
15 |
|
16 |
+Default EAPI for profiles & \compactfeatureref{profile-eapi-default} & |
17 |
+ 0 & 0 & 0 & 0 & Top-level \\ |
18 |
+ |
19 |
Profile files as directories & \compactfeatureref{profile-file-dirs} & |
20 |
No & No & Yes & Yes & Yes \\ |
21 |
|
22 |
@@ -555,6 +558,8 @@ EAPI 9 is EAPI 8 with the following changes: |
23 |
|
24 |
\begin{compactitem} |
25 |
\item Comments in profiles \t{parent} file, \featureref{parent-comments}. |
26 |
+\item Different default EAPI for profiles, \featureref{profile-eapi-default}. |
27 |
+ |
28 |
\end{compactitem} |
29 |
|
30 |
\ChangeWhenAddingAnEAPI{9} |
31 |
diff --git a/profiles.tex b/profiles.tex |
32 |
index 6fa8a1c..de59f0a 100644 |
33 |
--- a/profiles.tex |
34 |
+++ b/profiles.tex |
35 |
@@ -50,8 +50,27 @@ this file must not contain comments or blank lines. |
36 |
A profile directory may contain an \t{eapi} file. This file, if it exists, must contain a single |
37 |
line with the name of an EAPI\@. This specifies the EAPI to use when handling the directory in |
38 |
question; a package manager must not attempt to use any profile using a directory which requires an |
39 |
-EAPI it does not support. If no \t{eapi} file is present, EAPI 0 shall be used. The EAPI is neither |
40 |
-inherited via the \t{parent} file nor in subdirectories. |
41 |
+EAPI it does not support. |
42 |
+ |
43 |
+\featurelabel{profile-eapi-default} If no \t{eapi} file is present, the default depends on the EAPI |
44 |
+of the top-level profiles directory (see section~\ref{sec:profiles-dir}). That EAPI shall be used |
45 |
+if table~\ref{tab:profile-eapi-default} lists it as ``top-level''. Otherwise, EAPI 0 shall be used. |
46 |
+ |
47 |
+The EAPI is neither inherited via the \t{parent} file nor in subdirectories. |
48 |
+ |
49 |
+\ChangeWhenAddingAnEAPI{9} |
50 |
+\begin{centertable}{Default EAPI for profiles} |
51 |
+ \label{tab:profile-eapi-default} |
52 |
+ \begin{tabular}{ll} |
53 |
+ \toprule |
54 |
+ \multicolumn{1}{c}{\textbf{EAPI}} & |
55 |
+ \multicolumn{1}{c}{\textbf{Default EAPI?}} \\ |
56 |
+ \midrule |
57 |
+ 0, 1, 2, 3, 4, 5, 6, 7, 8 & 0 \\ |
58 |
+ 9 & Top-level \\ |
59 |
+ \bottomrule |
60 |
+ \end{tabular} |
61 |
+\end{centertable} |
62 |
|
63 |
\subsection{deprecated} |
64 |
If a profile contains a file named \t{deprecated}, it is treated as such. The first line of this |
65 |
-- |
66 |
2.35.1 |