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

["Ulrich Müller" <ulm@gentoo.org>]

commit:     fda72fbb4cec7d11939d64505cb30d0672a6e38f
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Feb 21 18:32:43 2022 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Apr 10 07:17:11 2023 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=fda72fbb

EAPI 9 profile EAPI defaults to top-level

Bug: https://bugs.gentoo.org/806181
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 eapi-differences.tex |  4 ++++
 profiles.tex         | 23 +++++++++++++++++++++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 79b3931..37e59cf 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -35,6 +35,9 @@ Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} &
 Comments in profiles \t{parent} file & \compactfeatureref{parent-comments} &
     No & No & No & Yes \\
 
+Default EAPI for profiles & \compactfeatureref{profile-eapi-default} &
+    0 & 0 & 0 & Top-level \\
+
 Profile files as directories & \compactfeatureref{profile-file-dirs} &
     No & Yes & Yes & Yes \\
 
@@ -356,6 +359,7 @@ EAPI 9 is EAPI 8 with the following changes:
 
 \begin{compactitem}
 \item Comments in profiles \t{parent} file, \featureref{parent-comments}.
+\item Different default EAPI for profiles, \featureref{profile-eapi-default}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{9}

diff --git a/profiles.tex b/profiles.tex
index 6fa8a1c..de59f0a 100644
--- a/profiles.tex
+++ b/profiles.tex
@@ -50,8 +50,27 @@ this file must not contain comments or blank lines.
 A profile directory may contain an \t{eapi} file. This file, if it exists, must contain a single
 line with the name of an EAPI\@. This specifies the EAPI to use when handling the directory in
 question; a package manager must not attempt to use any profile using a directory which requires an
-EAPI it does not support. If no \t{eapi} file is present, EAPI 0 shall be used. The EAPI is neither
-inherited via the \t{parent} file nor in subdirectories.
+EAPI it does not support.
+
+\featurelabel{profile-eapi-default} If no \t{eapi} file is present, the default depends on the EAPI
+of the top-level profiles directory (see section~\ref{sec:profiles-dir}). That EAPI shall be used
+if table~\ref{tab:profile-eapi-default} lists it as ``top-level''. Otherwise, EAPI 0 shall be used.
+
+The EAPI is neither inherited via the \t{parent} file nor in subdirectories.
+
+\ChangeWhenAddingAnEAPI{9}
+\begin{centertable}{Default EAPI for profiles}
+    \label{tab:profile-eapi-default}
+    \begin{tabular}{ll}
+      \toprule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{1}{c}{\textbf{Default EAPI?}} \\
+      \midrule
+      0, 1, 2, 3, 4, 5, 6, 7, 8 & 0         \\
+      9                         & Top-level \\
+      \bottomrule
+    \end{tabular}
+\end{centertable}
 
 \subsection{deprecated}
 If a profile contains a file named \t{deprecated}, it is treated as such. The first line of this