<?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>15128</bug_id>
          
          <creation_ts>2023-05-30 15:45:49 +0000</creation_ts>
          <short_desc>Document key variables which are space seperated to help new users</short_desc>
          <delta_ts>2023-07-20 13:53:33 +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>4.3</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></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>4.3</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Randy MacLeod">randy.macleod</reporter>
          <assigned_to name="Michael Opdenacker">michael.opdenacker</assigned_to>
          <cc>alexandre.belloni</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>95603</commentid>
    <comment_count>0</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2023-05-30 15:45:49 +0000</bug_when>
    <thetext>From time to time, bitbake users suggest that bitbake could give better warnings about sytax errors. In practice this is not easy to do and if implemented is suspected to significantly degrade the parser performance. 

Alexandre Belloni who teaches Yocto to new users tells them that the simply have to memorize which key variables are space separated. We should document this list and explain in the docs that bitbake has limitations (isn&apos;t psychic).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95604</commentid>
    <comment_count>1</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2023-05-30 15:47:32 +0000</bug_when>
    <thetext>Alex, now that you are CCed, can you write a few sentences to get Michael started or to focus the discussion in Thursdays bug review?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95606</commentid>
    <comment_count>2</comment_count>
    <who name="Alexandre Belloni">alexandre.belloni</who>
    <bug_when>2023-05-30 16:44:31 +0000</bug_when>
    <thetext>IIRC, the discussion ended up with let&apos;s document the colon separated lists as most of the lists are space separated. I also replied on bug 13205, I honestly think we should simply close it.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95612</commentid>
    <comment_count>3</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2023-06-01 14:42:38 +0000</bug_when>
    <thetext>Will go over each variable in the glossary, and make sure that each one that wants a colon separated list is properly documented as such.

That&apos;s the best solution we found!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95768</commentid>
    <comment_count>4</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2023-06-21 08:11:43 +0000</bug_when>
    <thetext>Already merged one commit in BitBake:
https://git.openembedded.org/bitbake/commit/?id=d1779e2f7789e516efae434b3781c981d0ef4ded

And another one submitted for the Yocto Project manuals:
https://lore.kernel.org/yocto-docs/20230619161719.910423-1-michael.opdenacker@bootlin.com/T/#t

Once the latter is merged, we can close the bug.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95988</commentid>
    <comment_count>5</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2023-07-20 13:53:33 +0000</bug_when>
    <thetext>Can now close the bug thanks to this commit:
https://git.yoctoproject.org/yocto-docs/commit/?id=af5f4bfd213d2678c0f0463ddff321980d6c9669</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>