<?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>10095</bug_id>
          
          <creation_ts>2016-08-05 02:49:47 +0000</creation_ts>
          <short_desc>Suggested documentation for the currently undocumented *_task-foo override syntax</short_desc>
          <delta_ts>2017-04-10 18:17:22 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>BitBake User Manual</product>
          <component>bitbake-manual</component>
          <version>2.2</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>10 April 2017: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.3 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>ulfalizer</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>64929</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-05 02:49:47 +0000</bug_when>
    <thetext>There&apos;s a FOO_task-mytask override syntax that sets a variable just for the
duration of a single task, but it&apos;s currently undocumented. I suggest adding a
new entry to the end of &apos;3.2.1. Conditional Metadata&apos;:

  * Setting a variable for a single task: BitBake supports setting a variable
    just for the duration of a single task. Here is an example:

        FOO_task-configure = &quot;val 1&quot;
        FOO_task-compile = &quot;val 2&quot;

    In this example, FOO will have the value &quot;val 1&quot; while the do_configure
    task is executed, and the value &quot;val 2&quot; while the do_compile task is
    executed.
    
    Internally, this is implemented by prepending e.g. &quot;task-compile:&quot; to the
    value of OVERRIDES for the local datastore of the do_compile task.

    This syntax can also be combined with e.g. &quot;_prepend&quot;, as in the following
    example:

        EXTRA_OEMAKE_prepend_task-compile = &quot;${PARALLEL_MAKE} &quot;


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64953</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-08 16:40:31 +0000</bug_when>
    <thetext>Ulf, 

See http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#conditional-metadata for the new item in that list.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64961</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-08 19:27:43 +0000</bug_when>
    <thetext>One nit: The &quot;e.g.&quot; before &quot;_prepend&quot; got lost in

  This syntax can also be combined with &quot;_prepend&quot;

Without it, it sounds like it can only be combined with &quot;_prepend&quot; and not e.g. &quot;_append&quot;.

Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64970</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-08 20:51:46 +0000</bug_when>
    <thetext>(In reply to comment #2)
&gt; One nit: The &quot;e.g.&quot; before &quot;_prepend&quot; got lost in
&gt; 
&gt;   This syntax can also be combined with &quot;_prepend&quot;
&gt; 
&gt; Without it, it sounds like it can only be combined with &quot;_prepend&quot; and not
&gt; e.g. &quot;_append&quot;.

Look at this version - http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#conditional-metadata.  I didn&apos;t like the way it originally read.  Will this work?

&gt; 
&gt; Cheers,
&gt; Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64971</commentid>
    <comment_count>4</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-08 20:55:14 +0000</bug_when>
    <thetext>(In reply to comment #3)
&gt; (In reply to comment #2)
&gt; &gt; One nit: The &quot;e.g.&quot; before &quot;_prepend&quot; got lost in
&gt; &gt; 
&gt; &gt;   This syntax can also be combined with &quot;_prepend&quot;
&gt; &gt; 
&gt; &gt; Without it, it sounds like it can only be combined with &quot;_prepend&quot; and not
&gt; &gt; e.g. &quot;_append&quot;.
&gt; 
&gt; Look at this version -
&gt; http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.
&gt; html#conditional-metadata.  I didn&apos;t like the way it originally read.  Will
&gt; this work?

Looks good to me. I agree that &quot;this syntax can also be combined with for example...&quot; sounds a bit sloppy. :)

Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65312</commentid>
    <comment_count>5</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2016-08-18 15:59:42 +0000</bug_when>
    <thetext>Great, I was just about to file this.

One note to make is that if the task name contains underscores then they need to be replaced with hyphens when specifying the override e.g.

VARNAME_task-populate-sysroot = &quot;somevalue&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67558</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-25 20:12:03 +0000</bug_when>
    <thetext>Moving to 2.3 M2</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>71474</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-03-20 18:19:07 +0000</bug_when>
    <thetext>Setting to 2.3 M4.

Paul - See http://www.yoctoproject.org/docs/2.3/bitbake-user-manual/bitbake-user-manual.html#conditional-metadata and the &quot;Setting a Variable for a Single Task&quot; item in the list.  I added a new note.  Tell me if this is okay. 

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72228</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-04-10 18:17:22 +0000</bug_when>
    <thetext>Hi,

No review since March 20th... assuming okay.  Setting to RESOLVED and marking the doc flag &quot;done.&quot;

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>