diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 559010b0f3..fe1c100794 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -493,6 +493,19 @@
+ BB_GENERATE_MIRROR_TARBALLS
+
+
+ Causes tarballs of the Git repositories to be placed in the
+ DL_DIR
+ directory.
+ For performance reasons, creating and placing tarballs of
+ the Git repositories is not the default action by the
+ OpenEmbedded build system.
+
+
+
+
BB_NUMBER_THREADSThe maximum number of tasks BitBake should run in parallel at any one time.
@@ -1283,8 +1296,20 @@ Core layer for images cannot be removed
DL_DIR and the build system looks there
first to find source tarballs.
- When wiping and rebuilding, you can preserve this
- directory to speed up this part of subsequent builds.
+
+ When wiping and rebuilding, you can preserve this
+ directory to speed up this part of subsequent
+ builds.
+
+
+
+ Also, by default, the DL_DIR
+ does not contain tarballs of Git directories.
+ However, you can instruct the build process to save
+ these tarballs to the directory by using the
+ BB_GENERATE_MIRROR_TARBALLS
+ variable.
+