<?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>9966</bug_id>
          
          <creation_ts>2016-07-18 09:13:48 +0000</creation_ts>
          <short_desc>Suggested fleshing out of the do_install documentation</short_desc>
          <delta_ts>2016-07-18 20:40:55 +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.3</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>18 July 2016: IN PROGRESS REVIEW</status_whiteboard>
          <keywords></keywords>
          <priority>Undecided</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.2 M3</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>64090</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-07-18 09:13:48 +0000</bug_when>
    <thetext>&apos;8.1.12. do_install&apos; could be extended as follows to make it clearer that the working directory is ${B} and to warn against a common problem I&apos;ve seen:


  8.1.12. do_install
  
  Copies files that are to be packaged into the holding area ${D}. Runs with the
  current working directory set to ${B}, which is the compilation directory.
  
  Note {
  
  When installing files, be careful not to set the owner and group IDs of the
  installed files to unintended values. Some methods of copying files, notably
  recursive &apos;cp&apos;, can preserve the UID and/or GID of the original file, which is
  usually not what we want. The host-user-contaminated QA check checks for files
  that probably have the wrong ownership.
  
  Safe methods for installing files include the following:
  
    * The &apos;install&apos; utility. This should be the preferred method.
    * &apos;cp&apos; with --no-preserve=ownership
    * &apos;tar&apos; with --no-same-owner (see bin_package.bbclass for an example)
  
  }</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64117</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-07-18 19:20:15 +0000</bug_when>
    <thetext>Ulf, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-install for the changes and report back... thanks,

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64119</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-07-18 19:33:28 +0000</bug_when>
    <thetext>Maybe host-user-contaminated could use code highlighting like in &apos;5.6.7. QA Check Changes&apos;. Looks good otherwise.

Looks like host-user-contaminated isn&apos;t mentioned in &apos;7.62. insane.bbclass&apos;. I could open a separate ticket for that later.

Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64130</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-07-18 20:40:55 +0000</bug_when>
    <thetext>Ok - I added that formatting - http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-install.

If you want to open a separate ticket for the other issue please do so. 

I am going to set this bug to RESOLVED and place the doc flag in &quot;Done.&quot;

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>