<?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>11600</bug_id>
          
          <creation_ts>2017-06-01 13:44:50 +0000</creation_ts>
          <short_desc>PACKAGECONFIG_CONFARGS documentation is wrong</short_desc>
          <delta_ts>2017-06-06 14:11:08 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</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>06 June 2017: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.4 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Ross Burton">ross.burton</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</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>73600</commentid>
    <comment_count>0</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2017-06-01 13:44:50 +0000</bug_when>
    <thetext>The first sentence is correct:

&quot;A space-separated list of configuration options generated from the PACKAGECONFIG setting.&quot;

However the rest is wrong.

Something like:

&quot;&quot;&quot;
A space-separated list of configuration options generated from the PACKAGECONFIG setting.

Classes such as autotools.bbclass and cmake.bbclass use this variable to pass PACKAGECONFIG options to configure and cmake respectively.  If you are using PACKAGECONFIG but not a class which handles do_configure then you need to use PACKAGECONFIG_CONFARGS as appropriate.
&quot;&quot;&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73652</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-06-02 18:19:39 +0000</bug_when>
    <thetext>Ross, 

See http://www.yoctoproject.org/docs/2.3/ref-manual/ref-manual.html#var-PACKAGECONFIG_CONFARGS for an attempt at this change.  One thing we don&apos;t have is a do_cmake task documented in the ref-manual.  Do we need to set that up?  Right now, the changes I made link to a non-existent section for do_cmake.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73668</commentid>
    <comment_count>2</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2017-06-03 15:07:37 +0000</bug_when>
    <thetext>The &quot;configure&quot; and &quot;cmake&quot; words in my sample were executable programs not bitbake tasks, so should be just &quot;configure&quot; and &quot;cmake&quot; and not linked to anything else in the manual.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73709</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-06-05 22:25:57 +0000</bug_when>
    <thetext>Ross, 

See http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-PACKAGECONFIG_CONFARGS and tell me if this is okay for the variable description.  

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73718</commentid>
    <comment_count>4</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2017-06-05 23:18:53 +0000</bug_when>
    <thetext>The first paragraphs look good but please delete &quot;To illustrate how to use PACKAGECONFIG_CONFARGS, consider the following example [... ] thus avoiding having to use EXTRA_OECONF.&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73719</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-06-05 23:33:41 +0000</bug_when>
    <thetext>Ross, 

Please see http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-PACKAGECONFIG_CONFARGS for the correction.  Let me know if this is okay.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73730</commentid>
    <comment_count>6</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2017-06-06 10:46:03 +0000</bug_when>
    <thetext>Perfect.  Thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73746</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-06-06 14:11:08 +0000</bug_when>
    <thetext>Setting doc flag to &quot;done&quot;.

Applying to the top of the pyro tree for 2.3.1.

Scott

(see http://www.yoctoproject.org/docs/2.3.1/ref-manual/ref-manual.html#var-PACKAGECONFIG_CONFARGS for the fix in 2.3.1)</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>