<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>1935</bug_id>
          
          <creation_ts>2012-01-26 07:11:47 +0000</creation_ts>
          <short_desc>BBMASK is not documented</short_desc>
          <delta_ts>2012-01-27 10:24:13 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>7</classification_id>
          <classification>Build System, Metadata &amp; Runtime</classification>
          <product>BitBake</product>
          <component>bitbake</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>http://git.yoctoproject.org/cgit.cgi/yocto-docs/commit/?id=4406a8b0b85ac15070e2ccb1c57ef9801827a7f7</bug_file_loc>
          <status_whiteboard>27-jan-2012: Resolved/Fixed</status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Gary Thomas">gary</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>jessica.zhang</cc>
    
    <cc>poky.bs.watcher</cc>
    
    <cc>poky.watcher</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>---</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>18371</commentid>
    <comment_count>0</comment_count>
    <who name="Gary Thomas">gary</who>
    <bug_when>2012-01-26 07:11:47 +0000</bug_when>
    <thetext>The BBMASK variable is not documented in the bitbake user manual.

The only web page I could find which mentioned this at all was
  http://www.uv-ac.de/openembedded/openembedded-2.html
but that information is incorrect.

To get it to work, I had to use a more complete regular expression.
For example, to skip a collection of recipes, I ended up with this:
  BBMASK = &quot;.*/meta-ti/recipes-misc/&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18376</commentid>
    <comment_count>1</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2012-01-26 12:31:51 +0000</bug_when>
    <thetext>Assigning to Scott, I agree we should document this in the reference manual. As a quick start to documenting it:

The BBMASK variable can be used to &quot;hide&quot; recipes (and .bbappend files) which match the expression and stops bitbake from seeing them at all. Matching files would therefore never get parsed or otherwise used by bitbake. The value is passed to python&apos;s regular expression compiler so see python&apos;s documentation for complete syntax information. The expression is compared against the full paths to the files.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18380</commentid>
    <comment_count>2</comment_count>
    <who name="Gary Thomas">gary</who>
    <bug_when>2012-01-26 12:51:44 +0000</bug_when>
    <thetext>(In reply to comment #1)
&gt; Assigning to Scott, I agree we should document this in the reference manual. As
&gt; a quick start to documenting it:
&gt; 
&gt; The BBMASK variable can be used to &quot;hide&quot; recipes (and .bbappend files) which
&gt; match the expression and stops bitbake from seeing them at all. Matching files
&gt; would therefore never get parsed or otherwise used by bitbake. The value is
&gt; passed to python&apos;s regular expression compiler so see python&apos;s documentation
&gt; for complete syntax information. The expression is compared against the full
&gt; paths to the files.

Great start, thanks.

Remember, examples are often the best part of documentation :-)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18386</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2012-01-26 13:42:30 +0000</bug_when>
    <thetext>Gary... Can I use that example you put in the original bug report?

So the following skips a collection of recipes:

  BBMASK = &quot;.*/meta-ti/recipes-misc/&quot;


Does this mean all recipes in meta-ti/recipes-misc ?  why wouldn&apos;t the path end with some sort of wildcarding thing like &quot;.*/meta-ti/recipes-misc/*.bb&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18390</commentid>
    <comment_count>4</comment_count>
    <who name="Gary Thomas">gary</who>
    <bug_when>2012-01-26 14:30:47 +0000</bug_when>
    <thetext>(In reply to comment #3)
&gt; Gary... Can I use that example you put in the original bug report?
&gt; 
&gt; So the following skips a collection of recipes:
&gt; 
&gt;   BBMASK = &quot;.*/meta-ti/recipes-misc/&quot;
&gt; 
&gt; 
&gt; Does this mean all recipes in meta-ti/recipes-misc ?  why wouldn&apos;t the path end
&gt; with some sort of wildcarding thing like &quot;.*/meta-ti/recipes-misc/*.bb&quot;

It&apos;s searching for a regular expression match, which without any
anchors can be anywhere in the string.  Thus this expression will
match all of the recipes within that directory.  Your expression
works as well, but it would ignore .bbappend files which might
cause problems.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18405</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2012-01-27 10:24:13 +0000</bug_when>
    <thetext>Created a new glossary entry for the variable BBMASK.  I will likely add some usage stuff in Section 3.2.4 of the YP Reference Manual to supplement this entry.

See http://git.yoctoproject.org/cgit.cgi/yocto-docs/commit/?id=4406a8b0b85ac15070e2ccb1c57ef9801827a7f7 for the fix.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>