summaryrefslogtreecommitdiff
path: root/bitbake/doc/manual/usermanual.xml
diff options
context:
space:
mode:
authorRichard Purdie <rpurdie@linux.intel.com>2010-03-22 17:58:27 +0000
committerRichard Purdie <rpurdie@linux.intel.com>2010-03-25 17:25:30 +0000
commitcefeeb1aa30a9d8744a6ff9c51811ebc8d18c735 (patch)
tree7e630bf20d45d06576b53593780e3951437c8811 /bitbake/doc/manual/usermanual.xml
parent5060280a7ad3b0269b36a9abeff54534f18d5254 (diff)
downloadopenembedded-core-cefeeb1aa30a9d8744a6ff9c51811ebc8d18c735.tar.gz
openembedded-core-cefeeb1aa30a9d8744a6ff9c51811ebc8d18c735.tar.bz2
openembedded-core-cefeeb1aa30a9d8744a6ff9c51811ebc8d18c735.zip
usermanual.xml: Add documentation on bblayers.conf
(Bitbake rev: 879229d12c2830dba9e0cb794e61e3c698b8dcc7) Signed-off-by: Richard Purdie <rpurdie@linux.intel.com>
Diffstat (limited to 'bitbake/doc/manual/usermanual.xml')
-rw-r--r--bitbake/doc/manual/usermanual.xml4
1 files changed, 3 insertions, 1 deletions
diff --git a/bitbake/doc/manual/usermanual.xml b/bitbake/doc/manual/usermanual.xml
index 450ac77d7a..29cdf97a0a 100644
--- a/bitbake/doc/manual/usermanual.xml
+++ b/bitbake/doc/manual/usermanual.xml
@@ -269,7 +269,9 @@ of the event and the content of the <varname>FILE</varname> variable.</para>
<title>Parsing</title>
<section>
<title>Configuration Files</title>
- <para>The first of the classifications of metadata in BitBake is configuration metadata. This metadata is global, and therefore affects <emphasis>all</emphasis> packages and tasks which are executed. Currently, BitBake has hardcoded knowledge of a single configuration file. It expects to find 'conf/bitbake.conf' somewhere in the user specified <envar>BBPATH</envar>. That configuration file generally has include directives to pull in any other metadata (generally files specific to architecture, machine, <emphasis>local</emphasis> and so on.</para>
+ <para>The first of the classifications of metadata in BitBake is configuration metadata. This metadata is global, and therefore affects <emphasis>all</emphasis> packages and tasks which are executed.</para>
+ <papa>Bitbake will first search the current working directory for an optional "conf/bblayers.conf" configuration file. This file is expected to contain a BBLAYERS variable which is a space delimited list of 'layer' directories. For each directory in this list a "conf/layer.conf" file will be searched for and parsed with the LAYERDIR variable being set to the directory where the layer was found. The idea is these files will setup BBPATH and other variables correctly for a given build directory automatically for the user.</para>
+ <para>Bitbake will then expect to find 'conf/bitbake.conf' somewhere in the user specified <envar>BBPATH</envar>. That configuration file generally has include directives to pull in any other metadata (generally files specific to architecture, machine, <emphasis>local</emphasis> and so on.</para>
<para>Only variable definitions and include directives are allowed in .conf files.</para>
</section>
<section>