<?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>10348</bug_id>
          
          <creation_ts>2016-09-29 14:30:22 +0000</creation_ts>
          <short_desc>Suggested note to clarify how native recipes find dependencies</short_desc>
          <delta_ts>2016-10-03 19:27:25 +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>03 Oct 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</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>ross.burton</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>66712</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-09-29 14:30:22 +0000</bug_when>
    <thetext>Hello,

It&apos;s currently hard to see how native recipes find their build dependencies.
The description for native recipes in STAGING_DIR_HOST might also trick people
into thinking that native recipes are installed into host directories like
/usr.

Here&apos;s a suggested note to add to the native bullet point in the
STAGING_DIR_HOST glossary entry:

  Note {
  This does not mean that -native recipes are installed into host paths like
  /usr. Rather, they are installed into [STAGING_DIR_NATIVE]. When compiling
  -native recipes, standard build environment variables like [CPPFLAGS] and
  [CFLAGS] are set up so that both host paths and [STAGING_DIR_NATIVE] are
  searched for libraries and headers (using, for example, GCC&apos;s -isystem flag).

  This emphasises that the STAGING_DIR* variables should be viewed as an input
  variables by tasks such as [do_configure], [do_compile], and [do_install].
  Having the real system root correspond to STAGING_DIR_HOST makes conceptual
  sense for -native recipes, as they make use of host headers and libraries.
  }


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66714</commentid>
    <comment_count>1</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-09-29 14:41:01 +0000</bug_when>
    <thetext>I also just spotted an error in the STAGING_DIR_HOST glossary entry (that might be my fault). This is not correct for -native recipes:

  This sysroot is the one that the recipe&apos;s do_populate_sysroot task copies
  files into.


Instead, it could say this:

  For most recipes, this sysroot is the one that the recipe&apos;s
  [do_populate_sysroot] task copies files into. Exceptions include -native
  recipes, where do_populate_sysroot instead uses [STAGING_DIR_NATIVE].


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66725</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-09-29 15:11:02 +0000</bug_when>
    <thetext>Small typo: &quot;...as an input variables...&quot; should be &quot;...as input variables...&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66809</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-03 16:10:38 +0000</bug_when>
    <thetext>Ulf, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-STAGING_DIR_HOST for the re-write of the variable. 

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66812</commentid>
    <comment_count>4</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-10-03 16:22:34 +0000</bug_when>
    <thetext>Looks good to me.

Maybe it would make more sense to have the note after the second (native) bullet point, but I&apos;m okay with the current version if that&apos;s awkward to do or if you think that it spaces things out too much.

Thanks,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66833</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-03 19:27:25 +0000</bug_when>
    <thetext>Ulf, 

I wondered about the ultimate placement of that note.  It did not seem to fit at the bottom too well.  I will move it as suggested.  See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-STAGING_DIR_HOST.

Since you were okay either way... I am setting to RESOLVED and putting the doc flag to &quot;done.&quot;

Thanks,
Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>