From 718e3b49842520ca2523a88b6488ee3195a9ff6e Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 30 Jan 2013 15:42:26 -0600 Subject: 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 (From yocto-docs rev: f10f43a543e7b0892863e165d2902741a8823009) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../dev-manual/dev-manual-common-tasks.xml | 27 ++++++--- documentation/ref-manual/ref-variables.xml | 69 ++++++++++++++++------ 2 files changed, 71 insertions(+), 25 deletions(-) (limited to 'documentation') 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 @@ Excluding Recipes From the Build - You might find that there are groups of recipes you want to filter - out of the build process. + You might find that there are groups of recipes or append files + that you want to filter out of the build process. For example, recipes you know you will never use or want should not be part of the build. - Removing these recipes from parsing speeds up parts of the build. + Removing these files from parsing speeds up parts of the build. It is possible to filter or mask out .bb and .bbappend files. You can do this by providing an expression with the - BBMASK + BBMASK variable. Here is an example: - BBMASK = ".*/meta-mymachine/recipes-maybe/" + BBMASK = "/meta-mymachine/recipes-maybe/" - Here, all .bb and .bbappend files - in the directory that match the expression are ignored during the build - process. + Here, all .bb and + .bbappend files in the directory that matches + the expression are ignored during the build process. + See the glossary entry for the + BBMASK + variable for more information. + + + The value you provide is passed to python's regular expression + compiler. + The expression is compared against the full paths to the files. + For complete syntax information, see python's documentation at + . +
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 0a29502544..ff9a227db1 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -342,26 +342,61 @@ BBMASK - Prevents BitBake from processing recipes and recipe append files. - You can use the BBMASK variable to "hide" - these .bb and .bbappend files. - BitBake ignores any recipe or recipe append files that match the expression. + + Prevents BitBake from processing recipes and recipe + append files. + Use the BBMASK variable from within the + conf/local.conf file found + in the + Build Directory. + + + + You can use the BBMASK variable + to "hide" these .bb and + .bbappend files. + BitBake ignores any recipe or recipe append files that + match the expression. It is as if BitBake does not see them at all. - Consequently, matching files are not parsed or otherwise used by - BitBake. - The value you provide is passed to python's regular expression compiler. - For complete syntax information, see python's documentation at + Consequently, matching files are not parsed or otherwise + used by BitBake. + + The value you provide is passed to python's regular + expression compiler. + The expression is compared against the full paths to + the files. + For complete syntax information, see python's + documentation at . - The expression is compared against the full paths to the files. - For example, the following uses a complete regular expression to tell - BitBake to ignore all recipe and recipe append files in the - .*/meta-ti/recipes-misc/ directory: + + + + The following example uses a complete regular expression + to tell BitBake to ignore all recipe and recipe append + files in the /meta-ti/recipes-misc/ + directory: - BBMASK = ".*/meta-ti/recipes-misc/" - - Use the BBMASK variable from within the - conf/local.conf file found - in the Build Directory. + BBMASK = "/meta-ti/recipes-misc/" + + If you want to mask out multiple directories or recipes, + use the vertical bar to separate the regular expression + fragments. + This next example masks out multiple directories and + individual recipes: + + BBMASK = "meta-ti/recipes-misc/|meta-ti/recipes-ti/packagegroup/" + BBMASK .= "|.*meta-oe/recipes-support/" + BBMASK .= "|.*openldap" + BBMASK .= "|.*opencv" + BBMASK .= "|.*lzma" + + Notice how the vertical bar is used to append the fragments. + + When specifying a directory name, use the trailing + slash character to ensure you match just that directory + name. + + -- cgit v1.2.3-54-g00ecf