Gentoo Archives: gentoo-pms

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-pms@l.g.o
Cc: "Ulrich Müller" <ulm@g.o>
Subject: [gentoo-pms] [PATCH] ebuild-vars.tex: Clarify which variables can be defined by an eclass
Date: Thu, 17 Mar 2022 19:01:46
Message-Id: 20220317190131.32513-1-ulm@gentoo.org
1 Signed-off-by: Ulrich Müller <ulm@g.o>
2 ---
3 ebuild-vars.tex | 7 +++++--
4 1 file changed, 5 insertions(+), 2 deletions(-)
5
6 diff --git a/ebuild-vars.tex b/ebuild-vars.tex
7 index d07cca4..e7aab0a 100644
8 --- a/ebuild-vars.tex
9 +++ b/ebuild-vars.tex
10 @@ -43,8 +43,9 @@ All ebuilds must define at least the following variables:
11 \section{Optional Ebuild-defined Variables}
12 \label{sec:optional-vars}
13
14 -Ebuilds may define any of the following variables:
15 -\nobreakpar
16 +Ebuilds may define any of the following variables. Unless otherwise stated, any of them may be
17 +defined by an eclass.
18 +
19 \begin{description}
20 \item[EAPI] The EAPI\@. See below in section~\ref{sec:eapi}.
21 \item[HOMEPAGE] The URI or URIs for a package's homepage, including protocols.
22 @@ -147,6 +148,8 @@ EAPI, the package manager must make sure that the \t{EAPI} value obtained by sou
23 with bash is identical to the EAPI obtained by parsing. The ebuild must be treated as invalid if
24 these values are different.
25
26 +Eclasses must not attempt to modify the \t{EAPI} variable.
27 +
28 \subsection{SRC_URI}
29 \label{sec:src-uri-behaviour}
30
31 --
32 2.35.1

Replies