diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-01-30 15:42:26 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-02-14 17:24:00 +0000 |
commit | 718e3b49842520ca2523a88b6488ee3195a9ff6e (patch) | |
tree | 86fd2c12d3b82b0993a33e7a150e93e9e58423db /documentation/dev-manual/dev-manual-common-tasks.xml | |
parent | 6a926df682a3964d6b5bc65c6610acf7463adaee (diff) | |
download | poky-718e3b49842520ca2523a88b6488ee3195a9ff6e.tar.gz |
ref-manual, dev-manual: Updates to BBMASK variable.
Fixes YOCTO #3662
I added more information to the variable desription in the
glossary for BBMASK. The information included a bit more
syntax information as well as some more complex examples.
I added more reference information to the "Excluding Recipes
From the Build" section to help better describe how the
BBMASK variable works.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: f10f43a543e7b0892863e165d2902741a8823009)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 27 |
1 files changed, 19 insertions, 8 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 2ae83810e1..e7655ade9f 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -2321,27 +2321,38 @@ | |||
2321 | <title>Excluding Recipes From the Build</title> | 2321 | <title>Excluding Recipes From the Build</title> |
2322 | 2322 | ||
2323 | <para> | 2323 | <para> |
2324 | You might find that there are groups of recipes you want to filter | 2324 | You might find that there are groups of recipes or append files |
2325 | out of the build process. | 2325 | that you want to filter out of the build process. |
2326 | For example, recipes you know you will never use or want should not | 2326 | For example, recipes you know you will never use or want should not |
2327 | be part of the build. | 2327 | be part of the build. |
2328 | Removing these recipes from parsing speeds up parts of the build. | 2328 | Removing these files from parsing speeds up parts of the build. |
2329 | </para> | 2329 | </para> |
2330 | 2330 | ||
2331 | <para> | 2331 | <para> |
2332 | It is possible to filter or mask out <filename>.bb</filename> and | 2332 | It is possible to filter or mask out <filename>.bb</filename> and |
2333 | <filename>.bbappend</filename> files. | 2333 | <filename>.bbappend</filename> files. |
2334 | You can do this by providing an expression with the | 2334 | You can do this by providing an expression with the |
2335 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'>BBMASK</ulink></filename> | 2335 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink> |
2336 | variable. | 2336 | variable. |
2337 | Here is an example: | 2337 | Here is an example: |
2338 | <literallayout class='monospaced'> | 2338 | <literallayout class='monospaced'> |
2339 | BBMASK = ".*/meta-mymachine/recipes-maybe/" | 2339 | BBMASK = "/meta-mymachine/recipes-maybe/" |
2340 | </literallayout> | 2340 | </literallayout> |
2341 | Here, all <filename>.bb</filename> and <filename>.bbappend</filename> files | 2341 | Here, all <filename>.bb</filename> and |
2342 | in the directory that match the expression are ignored during the build | 2342 | <filename>.bbappend</filename> files in the directory that matches |
2343 | process. | 2343 | the expression are ignored during the build process. |
2344 | See the glossary entry for the | ||
2345 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink> | ||
2346 | variable for more information. | ||
2344 | </para> | 2347 | </para> |
2348 | |||
2349 | <note> | ||
2350 | The value you provide is passed to python's regular expression | ||
2351 | compiler. | ||
2352 | The expression is compared against the full paths to the files. | ||
2353 | For complete syntax information, see python's documentation at | ||
2354 | <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>. | ||
2355 | </note> | ||
2345 | </section> | 2356 | </section> |
2346 | 2357 | ||
2347 | <section id="platdev-appdev-srcrev"> | 2358 | <section id="platdev-appdev-srcrev"> |