summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml34
1 files changed, 17 insertions, 17 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index d2bd56dc13..e12fa32516 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -3193,10 +3193,11 @@
3193 access to the library itself and its associated headers. 3193 access to the library itself and its associated headers.
3194 The way this access is accomplished is by populating sysroot 3194 The way this access is accomplished is by populating sysroot
3195 with files. 3195 with files.
3196 One sysroot exists per "machine" for which the image is 3196 Each recipe has two sysroots in its work directory, one for
3197 being built. 3197 target files
3198 In practical terms, this means a sysroot exists for the target 3198 (<filename>recipe-sysroot</filename>) and one for files that
3199 machine, and a sysroot exists for the build host. 3199 are native to the build host
3200 (<filename>recipe-sysroot-native</filename>).
3200 <note> 3201 <note>
3201 You could find the term "staging" used within the Yocto 3202 You could find the term "staging" used within the Yocto
3202 project regarding files populating sysroot (e.g. the 3203 project regarding files populating sysroot (e.g. the
@@ -3214,12 +3215,6 @@
3214 task within the 3215 task within the
3215 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename> 3216 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename>
3216 directory. 3217 directory.
3217 </para>
3218
3219 <para>
3220 A subset of these files, as defined by the
3221 the <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>
3222 variable, automatically populates the sysroot.
3223 The reason for this limitation is that almost all files that 3218 The reason for this limitation is that almost all files that
3224 populate the sysroot are cataloged in manifests in order to 3219 populate the sysroot are cataloged in manifests in order to
3225 ensure the files can be removed later when a recipe is either 3220 ensure the files can be removed later when a recipe is either
@@ -3228,6 +3223,13 @@
3228 </para> 3223 </para>
3229 3224
3230 <para> 3225 <para>
3226 A subset of the files installed by the
3227 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-install'><filename>do_install</filename></ulink>
3228 task are used by the
3229 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
3230 task as defined by the the
3231 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>
3232 variable to automatically populate the sysroot.
3231 It is possible to modify the list of directories that populate 3233 It is possible to modify the list of directories that populate
3232 the sysroot. 3234 the sysroot.
3233 The following example shows how you could add the 3235 The following example shows how you could add the
@@ -3239,13 +3241,11 @@
3239 </para> 3241 </para>
3240 3242
3241 <para> 3243 <para>
3242 For information on variables you can use to help control how 3244 for a more complete description of the
3243 files sysroot is populated, see the 3245 <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></ulink>
3244 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS'><filename>SYSROOT_DIRS</filename></ulink>, 3246 task and its associated functions, see the
3245 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS_NATIVE'><filename>SYSROOT_DIRS_NATIVE</filename></ulink>, 3247 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-staging'><filename>staging</filename></ulink>
3246 and 3248 class.
3247 <ulink url='&YOCTO_DOCS_REF_URL;#var-SYSROOT_DIRS_BLACKLIST'><filename>SYSROOT_DIRS_BLACKLIST</filename></ulink>
3248 variables.
3249 </para> 3249 </para>
3250 </section> 3250 </section>
3251 3251