diff --git a/documentation/toaster-manual/figures/add-variable.png b/documentation/toaster-manual/figures/add-variable.png
new file mode 100644
index 0000000000..6bdcca705a
Binary files /dev/null and b/documentation/toaster-manual/figures/add-variable.png differ
diff --git a/documentation/toaster-manual/figures/bash-oecore.png b/documentation/toaster-manual/figures/bash-oecore.png
new file mode 100644
index 0000000000..801a5d911f
Binary files /dev/null and b/documentation/toaster-manual/figures/bash-oecore.png differ
diff --git a/documentation/toaster-manual/figures/set-variable.png b/documentation/toaster-manual/figures/set-variable.png
new file mode 100644
index 0000000000..d36b52754e
Binary files /dev/null and b/documentation/toaster-manual/figures/set-variable.png differ
diff --git a/documentation/toaster-manual/figures/variable-added.png b/documentation/toaster-manual/figures/variable-added.png
new file mode 100644
index 0000000000..518f25fa15
Binary files /dev/null and b/documentation/toaster-manual/figures/variable-added.png differ
diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.xml b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
index 869d2490ef..57a4343bc4 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.xml
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
@@ -867,58 +867,113 @@
CPU usage, and disk I/O.
- Following are several videos that show how to use the Toaster GUI:
-
- Build Configuration:
- This
- video
- overviews and demonstrates build configuration for Toaster.
-
- Toaster Homepage and Table Controls:
- This
- video
- goes over the Toaster entry page, and provides
- an overview of the data manipulation capabilities of
- Toaster, which include search, sorting and filtering by
- different criteria.
-
- Build Dashboard:
- This
- video
- shows you the build dashboard, a page providing an
- overview of the information available for a selected build.
-
- Image Information:
- This
- video
- walks through the information Toaster provides
- about images: packages installed and root file system.
-
- Configuration:
- This
- video
- provides Toaster build configuration information.
-
- Tasks:
- This
- video
- shows the information Toaster provides about the
- tasks run by the build system.
-
- Recipes and Packages Built:
- This
- video
- shows the information Toaster provides about recipes
- and packages built.
-
- Performance Data:
- This
- video
- shows the build performance data provided by
- Toaster.
-
-
+
+
+ Toaster Web Interface Videos
+
+
+ Following are several videos that show how to use the Toaster GUI:
+
+ Build Configuration:
+ This
+ video
+ overviews and demonstrates build configuration for Toaster.
+
+ Toaster Homepage and Table Controls:
+ This
+ video
+ goes over the Toaster entry page, and provides
+ an overview of the data manipulation capabilities of
+ Toaster, which include search, sorting and filtering by
+ different criteria.
+
+ Build Dashboard:
+ This
+ video
+ shows you the build dashboard, a page providing an
+ overview of the information available for a selected build.
+
+ Image Information:
+ This
+ video
+ walks through the information Toaster provides
+ about images: packages installed and root file system.
+
+ Configuration:
+ This
+ video
+ provides Toaster build configuration information.
+
+ Tasks:
+ This
+ video
+ shows the information Toaster provides about the
+ tasks run by the build system.
+
+ Recipes and Packages Built:
+ This
+ video
+ shows the information Toaster provides about recipes
+ and packages built.
+
+ Performance Data:
+ This
+ video
+ shows the build performance data provided by
+ Toaster.
+
+
+
+
+
+
+ Building a Specific Recipe Given Multiple Versions
+
+
+ Occasionally, a layer might provide more than one version of
+ the same recipe.
+ For example, the openembedded-core layer
+ provides two versions of the bash recipe
+ (i.e. 3.2.48 and 4.3.30-r0) and two versions of the
+ which recipe (i.e. 2.21 and 2.18).
+ The following figure shows this exact scenario:
+
+
+
+
+ By default, the OpenEmbedded build system builds one of the
+ two recipes.
+ For the bash case, version 4.3.30-r0 is
+ built by default.
+ Unfortunately, Toaster as it exists, is not able to override
+ the default recipe version.
+ If you would like to build bash 3.2.48, you need to set the
+ PREFERRED_VERSION
+ variable.
+ You can do so from Toaster, using the "Add variable" form,
+ which is available in the "BitBake variables" page of the
+ project configuration section as shown in the following screen:
+
+
+
+
+ To specify bash 3.2.48 as the version to build,
+ enter "PREFERRED_VERSION_bash" in the "Variable" field, and "3.2.48"
+ in the "Value" field.
+ Next, click the "Add variable" button:
+
+
+
+
+ After clicking the "Add variable" button, the settings for
+ PREFERRED_VERSION are added to the bottom
+ of the BitBake variables list.
+ With these settings, the OpenEmbedded build system builds the
+ desired version of the recipe rather than the default version:
+
+
+