From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 18C96158095 for ; Thu, 25 Aug 2022 16:42:42 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 33291E091B; Thu, 25 Aug 2022 16:42:41 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 1A145E091B for ; Thu, 25 Aug 2022 16:42:41 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 487C9341158 for ; Thu, 25 Aug 2022 16:42:40 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 0350858A for ; Thu, 25 Aug 2022 16:42:39 +0000 (UTC) From: "Ulrich Müller" 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" Message-ID: <1660838530.7ef569e7b5487784b5cab81daef60cd920da2082.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/variables/ X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-writing/variables/text.xml X-VCS-Directories: ebuild-writing/variables/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 7ef569e7b5487784b5cab81daef60cd920da2082 X-VCS-Branch: master Date: Thu, 25 Aug 2022 16:42:39 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: e31e9895-ee22-49b9-abe3-211edb036518 X-Archives-Hash: 5063c5a4c72b05cd33d5bba6fe0bf65d commit: 7ef569e7b5487784b5cab81daef60cd920da2082 Author: Ulrich Müller gentoo org> AuthorDate: Wed Aug 17 07:08:26 2022 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Thu Aug 18 16:02:10 2022 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=7ef569e7 ebuild-writing/variables: Add section about reserved variables Signed-off-by: Ulrich Müller gentoo.org> ebuild-writing/variables/text.xml | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml index 4c7df4f..d77f4b7 100644 --- a/ebuild-writing/variables/text.xml +++ b/ebuild-writing/variables/text.xml @@ -721,6 +721,41 @@ table. +
+Variables reserved for the package manager + + +

+Variables and functions that begin with any of the following strings (ignoring +case) are reserved for package manager use. Ebuilds must neither use them nor +rely upon them: +

+ +
    +
  • __ (two underscores)
    • +
  • abort
    • +
  • dyn
    • +
  • prep
    • +
+ +

+The same applies to functions and variables that contain any of the following +strings (ignoring case): +

+ +
    +
  • + ebuild (unless immediately preceded by another letter, and except + for the EBUILD_PHASE and EBUILD_PHASE_FUNC variables) +
    • +
  • hook
    • +
  • paludis
    • +
  • portage
    • +
+ + +
+
Version and Name Formatting Issues