summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggleton <paul.eggleton@linux.intel.com>2013-04-09 14:57:33 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-04-13 23:57:22 +0100
commit8bec6f0a7181257c8a3fbde06efa124a428ee6ec (patch)
tree5c242805371395344606429add640c3e00818446
parent35ec2a0ac1cd89e22ea68ff7ff4debbbd55df13f (diff)
downloadpoky-8bec6f0a7181257c8a3fbde06efa124a428ee6ec.tar.gz
ref-manual/ref-variables: correct and extend DEFAULT_PREFERENCE entry
Rewrote the description to break it up a bit and flow better. (From yocto-docs rev: 7f0e8cf693b3b0a77537a15f7962f9e0e05fddfa) Signed-off-by: Paul Eggleton <paul.eggleton@linux.com> Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/ref-variables.xml22
1 files changed, 21 insertions, 1 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 330a6df411..e5b4db5f13 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -741,7 +741,27 @@ Core layer for images cannot be removed
741 741
742 <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm> 742 <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm>
743 <glossdef> 743 <glossdef>
744 <para>Specifies the priority of recipes.</para> 744 <para>
745 Specifies a weak bias for recipe selection priority.
746 Use this variable when more than one provider/version
747 satisfies a dependency.
748 </para>
749 <para>
750 The most common usage of this is variable is to set
751 it to "-1" within a recipe for a development version of a
752 piece of software.
753 Using the variable in this way causes the stable version
754 of the recipe to build by default in the absence of
755 <filename><link linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></filename>
756 being used to build the development version.
757 </para>
758 <note>
759 The bias provided by <filename>DEFAULT_PREFERENCE</filename>
760 is weak and is overridden by
761 <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename>
762 if the selection priority is different between two layers
763 that contain different versions of the same recipe.
764 </note>
745 </glossdef> 765 </glossdef>
746 </glossentry> 766 </glossentry>
747 767