[oe-commits] Martin Jansa : bitbake.conf: Fix OVERRIDES description (After pb' s explanation)

[git version control]

Module: openembedded.git
Branch: martin_jansa/srcpv
Commit: 70af4a882915cb51302734ca0de3b810f05df072
URL:    http://gitweb.openembedded.net/?p=openembedded.git&a=commit;h=70af4a882915cb51302734ca0de3b810f05df072

Author: Martin Jansa <Martin.Jansa at gmail.com>
Date:   Thu Nov 19 20:18:55 2009 +0100

bitbake.conf: Fix OVERRIDES description (After pb's explanation)

Signed-off-by: Martin Jansa <Martin.Jansa at gmail.com>

---

 conf/bitbake.conf |   12 +++++++++---
 1 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/conf/bitbake.conf b/conf/bitbake.conf
index 4435fdd..b69b675 100644
--- a/conf/bitbake.conf
+++ b/conf/bitbake.conf
@@ -651,10 +651,16 @@ BUILDCFG_NEEDEDVARS ?= "TARGET_ARCH TARGET_OS"
 ### Config file processing
 ###
 
+# Overrides are processed left to right, so the ones that are named later take precedence.
+# You generally want them to go from least to most specific.
+# 
 # This means that an envionment variable named '<foo>_arm' overrides an
-# environment variable '<foo>' (when ${TARGET_ARCH} is arm). And the same: an
-# environment variable '<foo>_ramses' overrides both '<foo>' and '<foo>_arm
-# when ${MACHINE} is 'ramses'. And finally '<foo>_local' overrides anything.
+# environment variable '<foo>' (when ${TARGET_ARCH} is arm).
+# an environment variable '<foo>_ramses' overrides '<foo>' but doesn't override
+# '<foo>_arm' when ${MACHINE} is 'ramses'. 
+# If you use combination ie '<foo>_arm_ramses', then '<foo>_arm_ramses' will override 
+# '<foo>_arm' and then '<foo>' will be overriden with that value from '<foo>_arm'.
+# And finally '<foo>_local' overrides anything, but with lowest priority.
 #
 # This works for  functions as well, they are really just environment variables.
 # Default OVERRIDES to make compilation fail fast in case of build system misconfiguration.