diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 5ac8dbf737..893ef7ba07 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6346,24 +6346,24 @@
(DL_DIR).
You start with an empty downloads directory by either
removing the files in the existing directory or by
- setting DL_DIR to point to either
- an empty location or one that does not yet exist.
+ setting
+ DL_DIR to point to either an
+ empty location or one that does not yet exist.
- Create Your "own-mirror" From Your Downloads Directory:
+ Generate Tarballs of the Source Git Repositories:
Edit your local.conf configuration
file as follows:
- SOURCE_MIRROR_URL ?= "file:///home/your-download-dir/"
- INHERIT += "own-mirrors"
+ DL_DIR = "/home/your-download-dir/"
BB_GENERATE_MIRROR_TARBALLS = "1"
During the fetch process in the next step, BitBake
- looks in your mirror for source files.
- The
+ gathers the source files and creates tarballs in
+ the directory pointed to by DL_DIR.
+ See the
BB_GENERATE_MIRROR_TARBALLS
- variable causes the build process to create source
- tarballs in the downloads directory.
+ variable for more information.
Populate Your Downloads Directory Without Building:
@@ -6372,9 +6372,10 @@
$ bitbake target --runonly=fetch
- The downloads directory now has a "snapshot" of the
- source files used for the build.
- The directory also has the tarballs.
+ The downloads directory (i.e.
+ ${DL_DIR}) now has a "snapshot" of
+ the source files in the form of tarballs, which can
+ be used for the build.
Optionally Remove Any Git or other SCM Subdirectories From the Downloads Directory:
@@ -6389,7 +6390,8 @@
Once your downloads directory has everything it needs regarding
- source files, you can build your target.
+ source files, you can create your "own-mirror" and build
+ your target.
Understand that you can use the files to build the target
offline from any machine and at any time.
@@ -6400,12 +6402,22 @@
Using Local Files Only:
- Add the
+ Inside your local.conf file, add
+ the
+ SOURCE_MIRROR_URL
+ variable,
+ inherit the own-mirrors
+ class, and use the
BB_NO_NETWORK
- variables to your local.conf.
+ variable to your local.conf.
+ SOURCE_MIRROR_URL ?= "file:///home/your-download-dir/"
+ INHERIT += "own-mirrors"
BB_NO_NETWORK = "1"
+ The SOURCE_MIRROR_URL and
+ own-mirror class set up the system
+ to use the downloads directory as your "own mirror".
Using the BB_NO_NETWORK
variable makes sure that BitBake's fetching process
in step 3 stays local, which means files from