[gentoo-pms] Re: [PATCH] Allocate __* for package manager internals, blacklist it for ebuilds.

[Ulrich Mueller]

>>>>> On Tue, 11 Sep 2012, Brian Harring wrote:

> To varying degrees, existing PMs use names that aren't prefixed in
> some fashion indicating it's an internal- the end result being
> ebuilds/eclasses that rely on a PM internal (both bad for alternate
> PMs, and bad should that internal change).

> Further, the lack of a standardized namespace for the PMs internals
> means QA tools must maintain their own lists.  As such, allocate __*
> for the PM to use for it's internal functionality and variables.

We already have a section "Reserved Commands and Variables", and I
think that the information should be added there. See one-line patch
below.

I also wonder about the rest of the list: "abort", "dyn", "ebuild",
"hook", "paludis", "portage", "prep". The last one occurs in
src_prepare, so forbidding it in ebuilds doesn't look so reasonable. ;-)

Some of the others (like "dyn" and "hook") are used in eclasses.
Should repoman enforce that they're not used?

Ulrich


From d80c7b7933e07aeb9f55543e15839230f5ca005f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <ulm@g.o>
Date: Sun, 16 Sep 2012 08:25:15 +0200
Subject: [PATCH] Strings beginning with two underscores are reserved.

---
 pkg-mgr-commands.tex | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 772613e..06856e2 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -858,6 +858,7 @@ strings (ignoring case) are reserved for package manager use and may not be used
 ebuilds:
 
 \begin{compactitem}
+\item \t{\_\_} (two underscores) at beginning of string
 \item \t{abort}
 \item \t{dyn}
 \item \t{ebuild}
-- 
1.7.12