'8.1.12. do_install' could be extended as follows to make it clearer that the working directory is ${B} and to warn against a common problem I'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 'cp', 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 'install' utility. This should be the preferred method.
    * 'cp' with --no-preserve=ownership
    * 'tar' with --no-same-owner (see bin_package.bbclass for an example)
  
  }