diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
index 60f547d57c..ec89840fd9 100644
--- a/documentation/ref-manual/ref-structure.xml
+++ b/documentation/ref-manual/ref-structure.xml
@@ -323,10 +323,37 @@
The OpenEmbedded build system creates the
Build Directory
- during the build.
- By default, this directory is named build.
+ when you run one of the build environment setup scripts (i.e.
+ &OE_INIT_FILE;
+ or
+ oe-init-build-env-memres).
+
+ If you do not give the Build Directory a specific name when you run
+ a setup script, the name defaults to build.
+
+
+
+ The
+ TOPDIR variable
+ points to the Build Directory.
+
+
+
+ build/buildhistory
+
+
+ The OpenEmbedded build system creates this directory when you
+ enable the build history feature.
+ The directory tracks build information into image, packages, and
+ SDK subdirectories.
+ For information on the build history feature, see the
+ "Maintaining Build Output Quality"
+ section.
+
+
+
build/conf/local.conf
@@ -488,10 +515,18 @@
build/tmp/
- This directory receives all of the OpenEmbedded build system's output.
+ The OpenEmbedded build system creates and uses this directory
+ for all the build system's output.
+ The
+ TMPDIR
+ variable points to this directory.
+
+
+
BitBake creates this directory if it does not exist.
- As a last resort, to clean up a build and start it from scratch (other than the downloads),
- you can remove everything in the tmp directory or get rid of the
+ As a last resort, to clean up a build and start it from scratch
+ (other than the downloads), you can remove everything in the
+ tmp directory or get rid of the
directory completely.
If you do, you should also completely remove the
build/sstate-cache directory.
@@ -607,6 +642,19 @@
+
+ build/tmp/deploy/sdk/
+
+
+ The OpenEmbedded build system creates this directory to hold
+ toolchain installer scripts, which when executed, install the
+ sysroot that matches your target hardware.
+ You can find out more about these installers in the
+ "Optionally Building a Toolchain Installer"
+ section in the Yocto Project Application Developer's Guide.
+
+
+
build/tmp/sysroots/