Hello Scott, These nifty variables (introduced in May) are only mentioned in the glossary. They would be easier to find if they were also linked to from the description of do_populate_sysroot. I also noticed that the description of do_populate_sysroot has the same problem that the STAGING_DIR_HOST glossary entry had: STAGING_DIR_HOST is not the directory do_populate_sysroot uses for e.g. native recipes. Here's some suggested changes to fix both issues: 1. Replace the first paragraph of '8.1.23. do_populate_sysroot' with the following two paragraphs: Stages (copies) a subset of the files installed by the [do_install] task into the appropriate sysroot (see [STAGING_DIR_HOST]) to make them available to other recipes. Directories that would typically not be needed by other recipes at build time (e.g. /etc) are not copied by default. For information on what directories are copied by default, see the [SYSROOT_DIRS*](http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS) variables. These variables can be changed inside your recipe if you need to make additional (or fewer) directories available to other recipes at build time. 2. Replace the beginning of the SYSROOT_DIRS glossary entry with the following: Directories that are staged into the sysroot by the [do_populate_sysroot] task. By default, the following directories are staged: 3. Replace the beginning of the SYSROOT_DIRS_BLACKLIST glossary entry with the following: Directories that are not staged into the sysroot by the [do_populate_sysroot] task. This variable is used to exclude certain subdirectories of directories listed in [SYSROOT_DIRS] from staging. By default, the following directories are not staged: 4. Replace the beginning of the SYSROOT_DIRS_NATIVE glossary entry with the following: Extra directories staged into the sysroot by the [do_populate_sysroot] task for -native recipes, in addition to those specified in [SYSROOT_DIRS]. By default, the following extra directories are staged: Cheers, Ulf
Self-nit: Could say "listed" instead of "specified" to be a bit more casual.
Hi Ulf, Here are the fixes: 1. See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-populate_sysroot 2. See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS 3. See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS_BLACKLIST 4. See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS_NATIVE Thanks, Scott
This sounds a bit weird to me: For information on how to make these files available to other recipes, see the STAGING_DIR_HOST variable. Maybe it could say "access" instead, like below: For information on how to access these files from other recipes, see the [STAGING_DIR*](http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-STAGING_DIR_HOST) variables. Could this note be added to the end of the SYSROOT_DIRS_NATIVE entry too? Note { Programs built by -native recipes run directly from the sysroot ([STAGING_DIR_NATIVE]), which is why additional directories containing program executables and supporting files need to be staged. } Cheers, Ulf
Ulf, See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-populate_sysroot for the fix in the task. See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS_NATIVE for the new note. Thanks, Scott
STAGING_DIR_NATIVE could be linkified in the SYSROOT_DIRS_NATIVE glossary entry too. Other than that, it looks good to me! Thanks, Ulf
Ulf, Sorry about that... completely blew that one. It is fixed now. I am also setting to RESOLVED and putting the doc flag to "done." See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-SYSROOT_DIRS_NATIVE Scott