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: + + +