From 4ac930a18255fc7198b0802ab4f31eb27611ea41 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ulrich=20M=C3=BCller?= Date: Wed, 11 May 2022 23:55:40 +0200 Subject: [PATCH] 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. "ebuild" is not reserved if it occurs as substring of "rebuild", which is somewhat common in names. Bug: https://bugs.gentoo.org/843779 Signed-off-by: Ulrich Müller --- pkg-mgr-commands.tex | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index 6df5f32..8aa414a 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{ebuild} +\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} (unless it occurs as substring of \t{rebuild}) \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