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.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