From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1397103-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits))
(No client certificate requested)
by finch.gentoo.org (Postfix) with ESMTPS id 6C4B5158090
for <garchives@archives.gentoo.org>; Mon, 16 May 2022 06:15:16 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 98B0EE0802;
Mon, 16 May 2022 06:15:15 +0000 (UTC)
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id 775B4E0802
for <gentoo-commits@lists.gentoo.org>; Mon, 16 May 2022 06:15:15 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id 6CC00341194
for <gentoo-commits@lists.gentoo.org>; Mon, 16 May 2022 06:15:13 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id 9823FDC
for <gentoo-commits@lists.gentoo.org>; Mon, 16 May 2022 06:15:11 +0000 (UTC)
From: "Ulrich Müller" <ulm@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" <ulm@gentoo.org>
Message-ID: <1652513397.260e21bf65f67ad424e990306a7a4789b6b2f1de.ulm@gentoo>
Subject: [gentoo-commits] proj/pms:master commit in: /
X-VCS-Repository: proj/pms
X-VCS-Files: pkg-mgr-commands.tex
X-VCS-Directories: /
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Müller
X-VCS-Revision: 260e21bf65f67ad424e990306a7a4789b6b2f1de
X-VCS-Branch: master
Date: Mon, 16 May 2022 06:15:11 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: 7fa00ee9-48d2-4f44-82d8-c4f2e162d69e
X-Archives-Hash: ffcc27f709a63d3ba6b1a2bc5b3c4b79
Message-ID: <20220516061511.vQTE5LatABh-aa3Wp1DaEeTWPU076xU2ReR_QxUfqBM@z>
commit: 260e21bf65f67ad424e990306a7a4789b6b2f1de
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed May 11 21:55:40 2022 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sat May 14 07:29:57 2022 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=260e21bf
pkg-mgr-commands.tex: Tighten the spec for reserved names
"abort", "dyn" and "prep" are only reserved at the beginning of a name.
This appears to be their only (historical and recent) usage in Portage.
"ebuild" is allowed as substring of words like "rebuild", which is
somewhat common in names.
Bug: https://bugs.gentoo.org/843779
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
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..d4dcffe 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 immediately preceded by another letter)
\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 :