summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggleton <paul.eggleton@microsoft.com>2021-04-12 16:19:55 +1200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-04-15 20:18:58 +0100
commit70441f2b7348ab5f877cdb24bcaf76c35fb69338 (patch)
treed75b7fa157aa6e64571d8542be1e188e1170fa7f
parent71b78ef384472c7714a582907acc166ed4b7e6b1 (diff)
downloadpoky-70441f2b7348ab5f877cdb24bcaf76c35fb69338.tar.gz
poky-70441f2b7348ab5f877cdb24bcaf76c35fb69338.tar.bz2
poky-70441f2b7348ab5f877cdb24bcaf76c35fb69338.zip
ref-manual: add REQUIRED_VERSION and adjust PREFERRED_VERSION entry
Add REQUIRED_VERSION, add a reference to it in PREFERRED_VERSION and adjust the opening statement to read slightly better. (From yocto-docs rev: c1c0b3600f2f6e752faacfc877b80c2dda7cf522) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/variables.rst24
1 files changed, 20 insertions, 4 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 0574b78a1e..725600c0e5 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -5798,10 +5798,11 @@ system and gives an overview of their function and contents.
exclusive alternative providers.
:term:`PREFERRED_VERSION`
- If multiple versions of recipes exist, this variable determines which
- version is given preference. You must always suffix the variable with
- the :term:`PN` you want to select, and you should set the
- :term:`PV` accordingly for precedence.
+ If there are multiple versions of a recipe available, this variable
+ determines which version should be given preference. You must always
+ suffix the variable with the :term:`PN` you want to select (`python` in
+ the first example below), and you should specify the :term:`PV`
+ accordingly (`3.4.0` in the example).
The ``PREFERRED_VERSION`` variable supports limited wildcard use
through the "``%``" character. You can use the character to match any
@@ -5859,6 +5860,10 @@ system and gives an overview of their function and contents.
The ``\_forcevariable`` override is not handled specially. This override
only works because the default value of ``OVERRIDES`` includes "forcevariable".
+ If a recipe with the specified version is not available, a warning
+ message will be shown. See :term:`REQUIRED_VERSION` if you want this
+ to be an error instead.
+
:term:`PREMIRRORS`
Specifies additional paths from which the OpenEmbedded build system
gets source code. When the build system searches for source code, it
@@ -6216,6 +6221,17 @@ system and gives an overview of their function and contents.
the recipe will be skipped, and if the build system attempts to build
the recipe then an error will be triggered.
+ :term:`REQUIRED_VERSION`
+ If there are multiple versions of a recipe available, this variable
+ determines which version should be given preference.
+ :term:`REQUIRED_VERSION` works in exactly the same manner as
+ :term:`PREFERRED_VERSION`, except that if the specified version is not
+ available then an error message is shown and the build fails
+ immediately.
+
+ If both :term:`REQUIRED_VERSION` and :term:`PREFERRED_VERSION` are set
+ for the same recipe, the :term:`REQUIRED_VERSION` value applies.
+
:term:`RM_WORK_EXCLUDE`
With ``rm_work`` enabled, this variable specifies a list of recipes
whose work directories should not be removed. See the