summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml25
1 files changed, 25 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 188cd74935..21c1e42388 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -9999,6 +9999,31 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9999 PREFERRED_VERSION_python = "3.4.0" 9999 PREFERRED_VERSION_python = "3.4.0"
10000 PREFERRED_VERSION_linux-yocto = "3.19%" 10000 PREFERRED_VERSION_linux-yocto = "3.19%"
10001 </literallayout> 10001 </literallayout>
10002 <note>
10003 The specified version is matched against
10004 <link linkend='var-PV'><filename>PV</filename></link>,
10005 which does not necessarily match the version part of
10006 the recipe's filename.
10007 For example, consider two recipes
10008 <filename>foo_1.2.bb</filename> and
10009 <filename>foo_git.bb</filename> where
10010 <filename>foo_git.bb</filename> contains the following
10011 assignment:
10012 <literallayout class='monospaced'>
10013 PV = "1.1+git${SRCPV}"
10014 </literallayout>
10015 In this case, the correct way to select
10016 <filename>foo_git.bb</filename> is by using an
10017 assignment such as the following:
10018 <literallayout class='monospaced'>
10019 PREFERRED_VERSION_foo = "1.1+git%"
10020 </literallayout>
10021 Compare that previous example against the following
10022 incorrect example, which does not work:
10023 <literallayout class='monospaced'>
10024 PREFERRED_VERSION_foo = "git"
10025 </literallayout>
10026 </note>
10002 Sometimes the <filename>PREFERRED_VERSION</filename> 10027 Sometimes the <filename>PREFERRED_VERSION</filename>
10003 variable can be set by configuration files in a way that 10028 variable can be set by configuration files in a way that
10004 is hard to change. 10029 is hard to change.