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 2/2] Distinguish between "phase" and "phase function"
Date: Sat, 14 Jan 2023 09:30:30
Message-Id: 20230114093008.25265-2-ulm@gentoo.org
In Reply to: [gentoo-pms] [PATCH 1/2] names.tex: Specify eclass names by "Ulrich Müller"
1 Signed-off-by: Ulrich Müller <ulm@g.o>
2 ---
3 ebuild-functions.tex | 6 +++---
4 eclasses.tex | 2 +-
5 2 files changed, 4 insertions(+), 4 deletions(-)
6
7 diff --git a/ebuild-functions.tex b/ebuild-functions.tex
8 index 0c745c3..03021ec 100644
9 --- a/ebuild-functions.tex
10 +++ b/ebuild-functions.tex
11 @@ -476,9 +476,9 @@ source files from their respective locations, with notes concerning licensing if
12
13 \featurelabel{default-phase-funcs} In EAPIs listed in
14 table~\ref{tab:default-phase-function-table} as supporting \t{default_} phase functions, a function
15 -named \t{default_}(phase) that behaves as the default implementation for that EAPI shall be defined
16 -when executing any ebuild phase listed in the table. Ebuilds must not call these functions except
17 -when in the phase in question.
18 +named \t{default_<phase-function>}) that behaves as the default implementation for that EAPI shall
19 +be defined when executing any ebuild phase function listed in the table. Ebuilds must not call
20 +these functions except when in the phase in question.
21
22 \ChangeWhenAddingAnEAPI{8}
23 \begin{centertable}{EAPIs supporting \t{default_} phase functions}
24 diff --git a/eclasses.tex b/eclasses.tex
25 index 0b9b5d4..ab305aa 100644
26 --- a/eclasses.tex
27 +++ b/eclasses.tex
28 @@ -87,7 +87,7 @@ should the author wish to override it he can access the function in \t{foo.eclas
29 \t{foo_src_compile}.
30
31 \t{EXPORT_FUNCTIONS} must only be used on ebuild phase functions. The function that is aliased
32 -must be named \t{eclassname_phasefunctionname}, where \t{eclassname} is the name of the eclass.
33 +must be named \t{eclassname_<phase-function>}, where \t{eclassname} is the name of the eclass.
34
35 If \t{EXPORT_FUNCTIONS} is called multiple times for the same phase function, the last call takes
36 precedence. Eclasses may not rely upon any particular behaviour if they inherit another eclass
37 --
38 2.39.0