From 802e4c1135c4eb451e504996aa797c04736496d4 Mon Sep 17 00:00:00 2001 From: "Robert P. J. Day" Date: Wed, 17 Jun 2026 07:56:49 -0400 Subject: [PATCH] ref-manual: add more explanation to glossary variable LICENSE Add the following to the variable glossary LICENSE entry: - it is a required variable in an OE recipe - it must be accompanied by LIC_FILES_CHKSUM, except in the case where LICENSE = "CLOSED" (From yocto-docs rev: 1b819d324780a699d9307a2d4e68c69b576ab748) Signed-off-by: Robert P. J. Day Signed-off-by: Antonin Godard (cherry picked from commit a75f75fe86c339246b94b78c593c54647a75ba6a) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 66bd13a7b6..db1f8766fc 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -5349,7 +5349,8 @@ system and gives an overview of their function and contents. section in the Yocto Project Development Tasks Manual. :term:`LICENSE` - The list of source licenses for the recipe. Follow these rules: + This is a required field in an OpenEmbedded recipe file, and should + contain a list of source licenses for the recipe. Follow these rules: - Do not use spaces within individual license names. @@ -5389,6 +5390,12 @@ system and gives an overview of their function and contents. LICENSE:${PN} = "GPL-2.0.only" LICENSE:${PN}-doc = "GFDL-1.2" + .. note:: + + A recipe's :term:`LICENSE` value must be accompanied by an associated + :term:`LIC_FILES_CHKSUM` value, except in the special case where + the :term:`LICENSE` value is set to "CLOSED". + :term:`LICENSE_CREATE_PACKAGE` Setting :term:`LICENSE_CREATE_PACKAGE` to "1" causes the OpenEmbedded build system to create an extra package (i.e.