<?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>10400</bug_id>
          
          <creation_ts>2016-10-07 22:32:45 +0000</creation_ts>
          <short_desc>Explaining what datastore funcs. do when a variable does not exist</short_desc>
          <delta_ts>2016-10-11 13:54:48 +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>11 Oct 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Undecided</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.3 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>ulfalizer</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>kergoth</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>ross.burton</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>67071</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-10-07 22:32:45 +0000</bug_when>
    <thetext>Explaining what datastore funcs. do when a variable does not exist

Hello Scott,

Here&apos;s some suggested additions to &apos;3.11.1. Functions for Accessing Datastore
Variables&apos; to explain what happens when the variable does not exist:

  * Add this to the d.getVar() description:

      Returns None if the variable &quot;X&quot; does not exist.

  * Add this to the d.appendVar() description:

      Acts like d.setVar(&quot;X&quot;, &quot;value&quot;) if the variable &quot;X&quot; does not exist.

  * Add this to the d.prependVar() description (same as above):

      Acts like d.setVar(&quot;X&quot;, &quot;value&quot;) if the variable &quot;X&quot; does not exist.

  * Add this to the d.delVar() description:

      Does nothing if the variable &quot;X&quot; does not exist.

  * Add this to the d.renameVar() description:

      Does nothing if the variable &quot;X&quot; does not exist.

  * Add this to the d.getVarFlag() description:

      Returns None if either the variable &quot;X&quot; or the named flag does not exist.

  * Add this to the d.appendVarFlag() description:

      Acts like d.setVarFlag(&quot;X&quot;, flag, &quot;value&quot;) if the named flag does not
      exist.

  * Add this to the d.prependVarFlag() description (same as above):

      Acts like d.setVarFlag(&quot;X&quot;, flag, &quot;value&quot;) if the named flag does not
      exist.

  * Add this to the d.getVarFlags() description:

      Returns None if the variable &quot;X&quot; does not exist.

  * Add this to the d.delVarFlags() description:

      Does nothing if the variable &quot;X&quot; does not exist.

  * Add this to the d.expand() description:

      References to variables that do not exist are left as is. For example,
      d.expand(&quot;foo ${X}&quot;) expands to the literal string &quot;foo ${X}&quot; if the
      variable &quot;X&quot; does not exist.


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67098</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-10 18:50:39 +0000</bug_when>
    <thetext>Ulf, 

See http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#functions-for-accessing-datastore-variables for the additions. 

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67114</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-10-11 00:46:17 +0000</bug_when>
    <thetext>Looks good to me.

Thanks,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67137</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-11 13:54:48 +0000</bug_when>
    <thetext>Thanks, 

Setting to RESOLVED and putting the doc flag to &quot;done.&quot;

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>