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 15A2515808E for ; Sun, 24 Apr 2022 08:20:25 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A16C3E0886; Sun, 24 Apr 2022 08:20:23 +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) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id C1E61E0886 for ; Sun, 24 Apr 2022 08:20:20 +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 00306341974 for ; Sun, 24 Apr 2022 08:20:12 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 24290105 for ; Sun, 24 Apr 2022 08:20:10 +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: <1650702635.dfeecf62f875f4a00de666b17902701da64576ad.ulm@gentoo> Subject: [gentoo-commits] proj/policy-guide:master commit in: / X-VCS-Repository: proj/policy-guide X-VCS-Files: ebuild-format.rst X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: dfeecf62f875f4a00de666b17902701da64576ad X-VCS-Branch: master Date: Sun, 24 Apr 2022 08:20:10 +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: 140df370-3b8d-4dbd-a7d9-5ea011a68f1c X-Archives-Hash: 737a4de419edb0947936ee60ecc2eb0a commit: dfeecf62f875f4a00de666b17902701da64576ad Author: Ulrich Müller gentoo org> AuthorDate: Sat Apr 23 08:30:35 2022 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 23 08:30:35 2022 +0000 URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=dfeecf62 ebuild-format: LICENSE must not contain variable references As discussed in #gentoo-qa. Signed-off-by: Ulrich Müller gentoo.org> ebuild-format.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/ebuild-format.rst b/ebuild-format.rst index a5bf5aa..041c088 100644 --- a/ebuild-format.rst +++ b/ebuild-format.rst @@ -108,3 +108,21 @@ wrapping, appending, etc.). when working with large number of ebuilds. The tool has only limited ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds. + + +.. index:: license; variable + +LICENSE must not contain variables +---------------------------------- +:PG: 0106 +:Source: QA +:Reported: no + +The ``LICENSE`` variable in an ebuild must specify all the license names +verbatim, without referring to any variables. The only exception is +(implicit or explicit) use of ``LICENSE`` itself, i.e. appending is +allowed. + +*Rationale*: since license names do not contain dynamic parts (such as +package versions), using variables there has little advantage. On the +other hand, variables reduce the usefulness of plain tools such as grep.