<?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>5214</bug_id>
          
          <creation_ts>2013-09-17 10:57:42 +0000</creation_ts>
          <short_desc>Improve PACKAGECONFIG explanation</short_desc>
          <delta_ts>2013-10-07 16:33:02 +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>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>http://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=9a66296f090f4ef023b3b5ae6f237676b6e9bd87</bug_file_loc>
          <status_whiteboard>07 October 2013: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>1.5</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Gary Thomas">gary</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>jessica.zhang</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>ross.burton</cc>
    
    <cc>srifenbark</cc>
    
    <cc>twoerner</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>36774</commentid>
    <comment_count>0</comment_count>
    <who name="Gary Thomas">gary</who>
    <bug_when>2013-09-17 10:57:42 +0000</bug_when>
    <thetext>The scant section on PACKAGECONFIG in the ref-variables manual is still rather vague.
In particular, the various methods for setting the PACKAGECONFIG variable should be
explained as they are quite varied and arcane.  For example, the simplest but perhaps
the most intrusive way to set this is using a .bbappend file, but there are other ways,
each of which have their own different/unique syntax.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36802</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-17 15:35:36 +0000</bug_when>
    <thetext>Paul, 

Could you provide some more information on how to use this variable here?  

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37672</commentid>
    <comment_count>2</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-10-07 10:38:02 +0000</bug_when>
    <thetext>The documentation covers *writing* a PACKAGECONFIG block, but it doesn&apos;t cover *changing* a PACKAGECONFIG statement.  Two ways: bbappend or conf file.  Some very rough notes that need to be expanded:

bbappend.  Create a [packagename].bbappend in your layer and override the value of PACKAGECONFIG.  It can either be overridden completely (PACKAGECONFIG=&quot;foo bar&quot;) or just amended (PACKAGECONFIG_append = &quot; bar&quot;).

conf file, such as local.conf or mydistro.conf.  The same method applies but the variable needs to be PACKAGECONFIG_pn-[packagename], i.e. PACKAGECONFIG_pn-libfoo = &quot;foo bar&quot;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37679</commentid>
    <comment_count>3</comment_count>
    <who name="Trevor Woerner">twoerner</who>
    <bug_when>2013-10-07 13:27:49 +0000</bug_when>
    <thetext>(In reply to comment #2)
&gt; conf file, such as local.conf or mydistro.conf.  The same method applies but
&gt; the variable needs to be PACKAGECONFIG_pn-[packagename], i.e.
&gt; PACKAGECONFIG_pn-libfoo = &quot;foo bar&quot;.

Additionally, the experimentation I&apos;ve done seems to indicate that if you
want to _append to a package&apos;s PACKAGECONFIG in a conf file you need to use:

    PACKAGECONFIG_append_pn-[package] = &quot; foo bar&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37693</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-07 15:05:37 +0000</bug_when>
    <thetext>Hi, 

Here is an expanded glossary description for the PACKAGECONFIG variable.  I have tried to describe it now to cover some various use scenarios.  I do need it looked at for accuracy as I made some guesses and assumptions. 

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-PACKAGECONFIG

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37695</commentid>
    <comment_count>5</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-10-07 15:16:12 +0000</bug_when>
    <thetext>In the configuration block, give two examples for clarity:

PACKAGECONFIG_pn-[packagename]=&quot;f4 f5&quot;
PACKAGECONFIG_append_pn-[packagename] = &quot; f4&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37702</commentid>
    <comment_count>6</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2013-10-07 15:29:53 +0000</bug_when>
    <thetext>Please use pn-&lt;recipename&gt; instead of pn-[packagename] in these examples, since the syntax matches the convention in the rest of the manual and we&apos;re talking recipes not packages here.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37705</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-07 15:49:30 +0000</bug_when>
    <thetext>Hi, 

Check out the review changes here:

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-PACKAGECONFIG

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37706</commentid>
    <comment_count>8</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-10-07 15:54:08 +0000</bug_when>
    <thetext>The conf file examples lost their _pn-[recipename] parts.

  PACKAGECONFIG_pn-[recipename]=&quot;f4 f5&quot;
  PACKAGECONFIG_append_pn-[recipename] = &quot; f4&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37707</commentid>
    <comment_count>9</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2013-10-07 16:01:06 +0000</bug_when>
    <thetext>pn-&lt;recipename&gt; ...</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37708</commentid>
    <comment_count>10</comment_count>
    <who name="Trevor Woerner">twoerner</who>
    <bug_when>2013-10-07 16:11:14 +0000</bug_when>
    <thetext>I thought RRECOMMENDS was added to the PACKAGECONFIG option list

http://patchwork.openembedded.org/patch/57837/

bringing the PACKAGECONFIG option count to 5, not 4?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37709</commentid>
    <comment_count>11</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-07 16:16:21 +0000</bug_when>
    <thetext>Looks like it was.  I will add that to the list.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37710</commentid>
    <comment_count>12</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-07 16:20:41 +0000</bug_when>
    <thetext>Hi, 

Check out the review changes here:

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-PACKAGECONFIG

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37711</commentid>
    <comment_count>13</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-10-07 16:24:21 +0000</bug_when>
    <thetext>Submitted but not accepted, please remove the runtime recommends section.  Apart from that, looks good.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>37713</commentid>
    <comment_count>14</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-07 16:33:02 +0000</bug_when>
    <thetext>OK, 

I took the RRECOMMENDS stuff out and restored it to four rather than five things.  Here is the link - http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-PACKAGECONFIG

I am marking it RESOLVED and putting the doc requirement to &quot;Done&quot;.

Thanks, 
Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>