summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2022-04-23 10:30:35 +0200
committerUlrich Müller <ulm@gentoo.org>2022-04-23 10:30:35 +0200
commitdfeecf62f875f4a00de666b17902701da64576ad (patch)
treecc82447388adf7561e640865c85af2693997347b
parentuser-group: Update according to today's Council decision (diff)
downloadpolicy-guide-dfeecf62f875f4a00de666b17902701da64576ad.tar.gz
policy-guide-dfeecf62f875f4a00de666b17902701da64576ad.tar.bz2
policy-guide-dfeecf62f875f4a00de666b17902701da64576ad.zip
ebuild-format: LICENSE must not contain variable references
As discussed in #gentoo-qa. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
-rw-r--r--ebuild-format.rst18
1 files changed, 18 insertions, 0 deletions
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.