summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml53
1 files changed, 39 insertions, 14 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index b3562db578..764c8072da 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1230,37 +1230,40 @@ Core layer for images cannot be removed
1230 <glossentry id='var-DL_DIR'><glossterm>DL_DIR</glossterm> 1230 <glossentry id='var-DL_DIR'><glossterm>DL_DIR</glossterm>
1231 <glossdef> 1231 <glossdef>
1232 <para> 1232 <para>
1233 The central download directory used by the build process to store downloads. 1233 The central download directory used by the build process to
1234 You can set this directory by defining the <filename>DL_DIR</filename> 1234 store downloads.
1235 variable in the <filename>/conf/local.conf</filename> file. 1235 You can set this directory by defining the
1236 <filename>DL_DIR</filename> variable in the
1237 <filename>/conf/local.conf</filename> file.
1236 This directory is self-maintaining and you should not have 1238 This directory is self-maintaining and you should not have
1237 to touch it. 1239 to touch it.
1238 By default, the directory is <filename>downloads</filename> in the 1240 By default, the directory is <filename>downloads</filename>
1241 in the
1239 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. 1242 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
1240 <literallayout class='monospaced'> 1243 <literallayout class='monospaced'>
1241 #DL_DIR ?= "${TOPDIR}/downloads" 1244 #DL_DIR ?= "${TOPDIR}/downloads"
1242 </literallayout> 1245 </literallayout>
1243 To specify a different download directory, simply uncomment the line 1246 To specify a different download directory, simply remove
1244 and provide your directory. 1247 the comment from the line and provide your directory.
1245 </para> 1248 </para>
1246 1249
1247 <para> 1250 <para>
1248 During a first build, the system downloads many different source code 1251 During a first build, the system downloads many different
1249 tarballs from various upstream projects. 1252 source code tarballs from various upstream projects.
1250 Downloading can take a while, particularly if your network 1253 Downloading can take a while, particularly if your network
1251 connection is slow. 1254 connection is slow.
1252 Tarballs are all stored in the directory defined by 1255 Tarballs are all stored in the directory defined by
1253 <filename>DL_DIR</filename> and the build system looks there first 1256 <filename>DL_DIR</filename> and the build system looks there
1254 to find source tarballs. 1257 first to find source tarballs.
1255 <note> 1258 <note>
1256 When wiping and rebuilding, you can preserve this directory to speed 1259 When wiping and rebuilding, you can preserve this
1257 up this part of subsequent builds. 1260 directory to speed up this part of subsequent builds.
1258 </note> 1261 </note>
1259 </para> 1262 </para>
1260 1263
1261 <para> 1264 <para>
1262 You can safely share this directory between multiple builds on the 1265 You can safely share this directory between multiple builds
1263 same development machine. 1266 on the same development machine.
1264 For additional information on how the build process gets 1267 For additional information on how the build process gets
1265 source files when working behind a firewall or proxy server, 1268 source files when working behind a firewall or proxy server,
1266 see this specific question in the 1269 see this specific question in the
@@ -3353,6 +3356,28 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3353 </glossdef> 3356 </glossdef>
3354 </glossentry> 3357 </glossentry>
3355 3358
3359 <glossentry id='var-OEROOT'><glossterm>OEROOT</glossterm>
3360 <glossdef>
3361 <para>
3362 The directory from which the top-level build environment
3363 setup script is sourced.
3364 The Yocto Project makes two top-level build environment
3365 setup scripts available:
3366 <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
3367 and
3368 <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>.
3369 When you run one of these scripts, the
3370 <filename>OEROOT</filename> variable resolves to the
3371 directory that holds the script.
3372 </para>
3373
3374 <para>
3375 For additional information on how this variable is used,
3376 see the initialization scripts.
3377 </para>
3378 </glossdef>
3379 </glossentry>
3380
3356 <glossentry id='var-OLDEST_KERNEL'><glossterm>OLDEST_KERNEL</glossterm> 3381 <glossentry id='var-OLDEST_KERNEL'><glossterm>OLDEST_KERNEL</glossterm>
3357 <glossdef> 3382 <glossdef>
3358 <para> 3383 <para>