1 |
commit: 260e21bf65f67ad424e990306a7a4789b6b2f1de |
2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
3 |
AuthorDate: Wed May 11 21:55:40 2022 +0000 |
4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
5 |
CommitDate: Sat May 14 07:29:57 2022 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=260e21bf |
7 |
|
8 |
pkg-mgr-commands.tex: Tighten the spec for reserved names |
9 |
|
10 |
"abort", "dyn" and "prep" are only reserved at the beginning of a name. |
11 |
This appears to be their only (historical and recent) usage in Portage. |
12 |
|
13 |
"ebuild" is allowed as substring of words like "rebuild", which is |
14 |
somewhat common in names. |
15 |
|
16 |
Bug: https://bugs.gentoo.org/843779 |
17 |
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> |
18 |
|
19 |
pkg-mgr-commands.tex | 14 ++++++++++---- |
20 |
1 file changed, 10 insertions(+), 4 deletions(-) |
21 |
|
22 |
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex |
23 |
index 6df5f32..d4dcffe 100644 |
24 |
--- a/pkg-mgr-commands.tex |
25 |
+++ b/pkg-mgr-commands.tex |
26 |
@@ -1316,19 +1316,25 @@ Ebuilds must not run any of these commands once the current phase function has r |
27 |
|
28 |
\subsection{Reserved commands and variables} |
29 |
|
30 |
-Except where documented otherwise, all functions and variables that contain any of the following |
31 |
+Except where documented otherwise, all functions and variables that begin with any of the following |
32 |
strings (ignoring case) are reserved for package manager use and may not be used or relied upon by |
33 |
ebuilds: |
34 |
|
35 |
\begin{compactitem} |
36 |
-\item \t{__} (two underscores) at beginning of string |
37 |
+\item \t{__} (two underscores) |
38 |
\item \t{abort} |
39 |
\item \t{dyn} |
40 |
-\item \t{ebuild} |
41 |
+\item \t{prep} |
42 |
+\end{compactitem} |
43 |
+ |
44 |
+The same applies to functions and variables that contain any of the following strings (ignoring |
45 |
+case): |
46 |
+\nobreakpar |
47 |
+\begin{compactitem} |
48 |
+\item \t{ebuild} (unless immediately preceded by another letter) |
49 |
\item \t{hook} |
50 |
\item \t{paludis} |
51 |
\item \t{portage} |
52 |
-\item \t{prep} |
53 |
\end{compactitem} |
54 |
|
55 |
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : |