From 8bec6f0a7181257c8a3fbde06efa124a428ee6ec Mon Sep 17 00:00:00 2001 From: Paul Eggleton Date: Tue, 9 Apr 2013 14:57:33 +0100 Subject: 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(-) (limited to 'documentation/ref-manual') 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. + -- cgit v1.2.3-54-g00ecf