From: Scott Rifenbark <srifenbark@gmail.com>
Date: Fri, 15 Apr 2016 15:09:19 +0000 (-0700)
Subject: ref-manual: Updated the PREFERRED_PROVIDER variable with a note.
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6391dbfe489ac5565d1fce23a31a90f3616f158c;p=thirdparty%2Fopenembedded%2Fopenembedded-core-contrib.git

ref-manual: Updated the PREFERRED_PROVIDER variable with a note.

(From yocto-docs rev: 5d3a3e9ea8670f784f9c06cb244a9d5981bb1e76)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index d66fe1b0c67..4fb1f646465 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -9568,6 +9568,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
      PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86"
      PREFERRED_PROVIDER_virtual/libgl ?= "mesa"
                     </literallayout>
+                    <note>
+                        If you set <filename>PREFERRED_PROVIDER</filename>
+                        for a <filename>virtual/*</filename> item, then any
+                        recipe that
+                        <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link>
+                        that item that is not selected by
+                        <filename>PREFERRED_PROVIDER</filename> is prevented
+                        from building, which is usually desirable since this
+                        mechanism is designed to select between mutually
+                        exclusive alternative providers.
+                    </note>
                 </para>
             </glossdef>
         </glossentry>