<?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>10094</bug_id>
          
          <creation_ts>2016-08-05 02:47:32 +0000</creation_ts>
          <short_desc>Small suggested clarifications to the PACKAGES and FILES glossary entries</short_desc>
          <delta_ts>2016-08-08 20:41:36 +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>08 August 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Undecided</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.2 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>ulfalizer</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>64928</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-05 02:47:32 +0000</bug_when>
    <thetext>It&apos;s currently easy to miss how PACKAGES works w.r.t. files matching FILES for
many different packages. I suggest the following changes:

* Add this to the end of the PACKAGES glossary entry:

  During packaging, the [do_package] task goes through PACKAGES and uses the
  [FILES] variable corresponding to each package to assign files to the
  package. If a file matches the FILES variable for more than one package in
  PACKAGES, it will be assigned to the earliest (leftmost) one.

* Linkify PACKAGE_BEFORE_PN in the PACKAGES glossary entry.

* Add this to the end of the Note in the FILES glossary entry:

  You will also find the default value of the various FILES_* variables in this
  file.


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64939</commentid>
    <comment_count>1</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-08 06:54:01 +0000</bug_when>
    <thetext>One small change:

  If a file matches the FILES variable for more than one package in
  PACKAGES, it will be assigned to the earliest (leftmost) package.

(&quot;package&quot; instead of &quot;one&quot; at the end.)

Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64952</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-08 16:25:09 +0000</bug_when>
    <thetext>Ulf, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-PACKAGES for PACKAGES.  Note that I did not &quot;linkify&quot; that variable in the example.  I try not to link variables in code examples.  If you feel the reference is really important, I can add a separate cross-reference to it outside of the code example.

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-FILES for the addition at the end of the note for the FILES variable.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64959</commentid>
    <comment_count>3</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-08 19:22:16 +0000</bug_when>
    <thetext>Looks good to me. I&apos;m OK with not linkifying PACKAGE_BEFORE_PN.

Thanks,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64966</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-08 20:41:36 +0000</bug_when>
    <thetext>Thanks... setting to RESOLVED and putting doc flag to &quot;done&quot;.

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>