From a1295ed80ff4e80b423ac9e7511730319c82052a Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Fri, 1 Apr 2016 10:14:25 -0700
Subject: ref-manual: Updated PREFERRED_VERSION variable description

Fixes [YOCTO #8595]

Added some examples on how to force the version.

(From yocto-docs rev: 4a98ce1ed623cd9763731453316f2ff8d8b8b82a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/ref-manual/ref-variables.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'documentation')

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index ad87a63312..45015a4096 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -9589,6 +9589,15 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
      PREFERRED_VERSION_python = "2.7.3"
      PREFERRED_VERSION_linux-yocto = "3.19%"
                     </literallayout>
+                    If you want to force a particular version of a recipe,
+                    you can use "forcevariable" as follows:
+                    <literallayout class='monospaced'>
+     PREFERRED_VERSION_linux-yocto_forcevariable = "3.4%"
+                    </literallayout>
+                    Another method is to use a machine override:
+                    <literallayout class='monospaced'>
+     PREFERRED_VERSION_linux-yocto_qemux86 = "3.4%"
+                    </literallayout>
                 </para>
             </glossdef>
         </glossentry>
-- 
cgit v1.2.3-54-g00ecf