diff options
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"> |