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 1/2] pkg-mgr-commands.tex: Tighten the spec for reserved names
Date: Thu, 12 May 2022 17:07:26
Message-Id: 20220512170710.8707-1-ulm@gentoo.org
1 "abort", "dyn", "prep" are only reserved at the beginning of a name.
2 This appears to be their only (historical and recent) usage in Portage.
3
4 Bug: https://bugs.gentoo.org/843779
5 Signed-off-by: Ulrich Müller <ulm@g.o>
6 ---
7 pkg-mgr-commands.tex | 12 +++++++++---
8 1 file changed, 9 insertions(+), 3 deletions(-)
9
10 diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
11 index 6df5f32..7965e8e 100644
12 --- a/pkg-mgr-commands.tex
13 +++ b/pkg-mgr-commands.tex
14 @@ -1316,19 +1316,25 @@ Ebuilds must not run any of these commands once the current phase function has r
15
16 \subsection{Reserved commands and variables}
17
18 -Except where documented otherwise, all functions and variables that contain any of the following
19 +Except where documented otherwise, all functions and variables that begin with any of the following
20 strings (ignoring case) are reserved for package manager use and may not be used or relied upon by
21 ebuilds:
22
23 \begin{compactitem}
24 -\item \t{__} (two underscores) at beginning of string
25 +\item \t{__} (two underscores)
26 \item \t{abort}
27 \item \t{dyn}
28 +\item \t{prep}
29 +\end{compactitem}
30 +
31 +The same applies to functions and variables that contain any of the following strings (ignoring
32 +case):
33 +\nobreakpar
34 +\begin{compactitem}
35 \item \t{ebuild}
36 \item \t{hook}
37 \item \t{paludis}
38 \item \t{portage}
39 -\item \t{prep}
40 \end{compactitem}
41
42 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
43 --
44 2.35.1

Replies