From 50eb7e4226e26e4b7affc0537d980bd11d4ecf42 Mon Sep 17 00:00:00 2001 From: Paul Eggleton Date: Tue, 9 Apr 2013 14:57:33 +0100 Subject: [PATCH] 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 Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) 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 DEFAULT_PREFERENCE - Specifies the priority of recipes. + + Specifies a weak bias for recipe selection priority. + Use this variable when more than one provider/version + satisfies a dependency. + + + The most common usage of this is variable is to set + it to "-1" within a recipe for a development version of a + piece of software. + Using the variable in this way causes the stable version + of the recipe to build by default in the absence of + PREFERRED_VERSION + being used to build the development version. + + + The bias provided by DEFAULT_PREFERENCE + is weak and is overridden by + BBFILE_PRIORITY + if the selection priority is different between two layers + that contain different versions of the same recipe. +