<?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>13112</bug_id>
          
          <creation_ts>2019-01-02 21:50:15 +0000</creation_ts>
          <short_desc>FILESPATH and FILESOVERRIDES documentation lacks key detail</short_desc>
          <delta_ts>2019-02-19 01:03:05 +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.7</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>02 January 2019: ACCECPTED</bug_file_loc>
          <status_whiteboard>18 February 2019: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.7 M2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Richard Purdie">richard.purdie</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <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>82638</commentid>
    <comment_count>0</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2019-01-02 21:50:15 +0000</bug_when>
    <thetext>https://www.yoctoproject.org/docs/latest/ref-manual/ref-manual.html#var-FILESOVERRIDES

https://www.yoctoproject.org/docs/latest/ref-manual/ref-manual.html#var-FILESPATH

These two variables need to reference each other and include an example of how these combine to provide really powerful behavior.

The FILESPATH variable needs to mention that it is extended automatically using the overrides from FILESOVERRIDES.

I&apos;d also suggest an example is added, for example, if you put:

&quot;file://defconfig&quot; into SRC_URI, then have the directory structure:

files/defconfig
files/MACHINEA/defconfig
files/MACHINEB/defconfig

then MACHINE=MACHINEA will use the file from files/MACHINEA, MACHINE=MACHINEB will use the one from files/MACHINEB and any other machine would use the one from files/.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>82668</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2019-01-03 23:39:57 +0000</bug_when>
    <thetext>Richard, 

Look at https://yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#var-FILESPATH for updates to FILESPATH.  I am holding off on FILESOVERRIDES until FILESPATH is good.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83009</commentid>
    <comment_count>2</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2019-02-14 16:37:03 +0000</bug_when>
    <thetext>Scott,

I think to make most sense the ordering needs tweaking. Can you move the last two paragraphs (&quot;The default value for the ...&quot; and &quot;The FILESPATH variable is automatically &quot;) before the example?

This is because the example uses FILESOVERRIDES as well. If you do that I think this is good.

Cheers,

Richard</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83021</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2019-02-15 18:23:32 +0000</bug_when>
    <thetext>Richard, 

See https://yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#var-FILESPATH for the re-ordering.  

I also added a bit to the front of the https://yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#var-FILESOVERRIDES variable.

Let me know if all this is good and I will close the bug out.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83026</commentid>
    <comment_count>4</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2019-02-16 10:37:45 +0000</bug_when>
    <thetext>Looks good to me, I&apos;d just add a comment to FILESOVERRIDES to see FILESPATH for an example of how it works.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>83036</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2019-02-19 01:03:05 +0000</bug_when>
    <thetext>Richard, 

See https://yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#var-FILESOVERRIDES for the reference to the FILESPATH description.

I am going to set this to RESOLVED and put the doc flag to &quot;done.&quot;

Thanks, 
Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>