[patch] pkg-mgr-commands.tex: Tighten the spec for reserved names

0001-pkg-mgr-commands.tex-Tighten-the-spec-for-reserved-n.patch (text/plain), 1.73 KB, created by Ulrich Müller on 2022-05-12 07:06:33 UTC

From ace40852ad7144f66701e62230575f364aeba282 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <[e-mail]>
Date: Wed, 11 May 2022 23:55:40 +0200
Subject: [PATCH 1/2] pkg-mgr-commands.tex: Tighten the spec for reserved names
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

"abort", "dyn", "prep" are only reserved at the beginning of a name.
This appears to be their only (historical and recent) usage in Portage.

Bug: https://bugs.gentoo.org/843779
Signed-off-by: Ulrich Müller <[e-mail]>
---
 pkg-mgr-commands.tex | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 6df5f32..7965e8e 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -1316,19 +1316,25 @@ Ebuilds must not run any of these commands once the current phase function has r
 
 \subsection{Reserved commands and variables}
 
-Except where documented otherwise, all functions and variables that contain any of the following
+Except where documented otherwise, all functions and variables that begin with any of the following
 strings (ignoring case) are reserved for package manager use and may not be used or relied upon by
 ebuilds:
 
 \begin{compactitem}
-\item \t{__} (two underscores) at beginning of string
+\item \t{__} (two underscores)
 \item \t{abort}
 \item \t{dyn}
+\item \t{prep}
+\end{compactitem}
+
+The same applies to functions and variables that contain any of the following strings (ignoring
+case):
+\nobreakpar
+\begin{compactitem}
 \item \t{ebuild}
 \item \t{hook}
 \item \t{paludis}
 \item \t{portage}
-\item \t{prep}
 \end{compactitem}
 
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
-- 
2.35.1