<?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>8941</bug_id>
          
          <creation_ts>2016-01-18 13:45:43 +0000</creation_ts>
          <short_desc>Unclear information about auto.conf</short_desc>
          <delta_ts>2016-04-14 14:29:24 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Mega Manual</product>
          <component>mega-manual</component>
          <version>2.1</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>01 April 2016: RESLOVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.1 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>New (Never tested)</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>57915</commentid>
    <comment_count>0</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2016-01-18 13:45:43 +0000</bug_when>
    <thetext>When trying to understand how to use auto.conf I found some misleading steps in mega-manual: 
&quot;The files site.conf and auto.conf are not created by the environment initialization script. If you want these configuration files, you must create them yourself: &quot;
So I must create auto.conf manually!
Still one paragraph bellow is specified we do not create this file by our hands: 
&quot;
auto.conf: This file is not hand-created. Rather, the file is usually created and written to by an autobuilder. The settings put into the file are typically the same as you would find in the conf/local.conf or the conf/site.conf files. &quot;

Please clarify this in manual.

Paul, could you please help?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>57928</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-01-18 17:43:45 +0000</bug_when>
    <thetext>Hi, 

Yes - that is confusing.  I updated the wording to what I think is really going on.  Paul should check it over.  Here is the section in the ref-manual: http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#user-configuration.

Let me know.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58803</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-09 22:45:55 +0000</bug_when>
    <thetext>let this run for another month then will set to RESOLVED if no further feedback.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58809</commentid>
    <comment_count>3</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2016-02-10 08:02:50 +0000</bug_when>
    <thetext>I am ok with the modifications.
Should we assign it to Paul?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58849</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-10 18:50:56 +0000</bug_when>
    <thetext>Thanks Bogdan, 

Paul is on the CC list for this bug.  I will wait a while to see if he has anything to say about the fix.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>58854</commentid>
    <comment_count>5</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2016-02-10 20:33:28 +0000</bug_when>
    <thetext>I&apos;m fairly happy with the new content. The note box does duplicate the later statement about auto.conf / site.conf containing the same sorts of settings as local.conf though, but that&apos;s not a major issue.

The only thing possibly worth adding is a mention of the order in which these files are read - which is site.conf, auto.conf and then local.conf. The normal rules about the different types of assignment statement apply, but for example 
if you have VARIABLE = &quot;value1&quot; in auto.conf and VARIABLE = &quot;value2&quot; in local.conf, VARIABLE&apos;s value will be &quot;value2&quot; since local.conf gets parsed later.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>59029</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-02-15 16:22:15 +0000</bug_when>
    <thetext>See the last paragraph in http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#user-configuration and let me know if that addresses this extra point.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60706</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-04-01 18:18:25 +0000</bug_when>
    <thetext>Hi, 

No further comments on this.  I am setting to RESOLVED and marking the doc flag to &quot;done.&quot;

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>61211</commentid>
    <comment_count>8</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2016-04-14 14:29:24 +0000</bug_when>
    <thetext>This is resolved now.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>