diff --git a/documentation/sdk-manual/sdk-extensible.xml b/documentation/sdk-manual/sdk-extensible.xml index 9546bedc52..d758872b8a 100644 --- a/documentation/sdk-manual/sdk-extensible.xml +++ b/documentation/sdk-manual/sdk-extensible.xml @@ -1393,8 +1393,9 @@ Working With Recipes - When building a recipe with devtool build, the - typical build progression is as follows: + When building a recipe using the + devtool build command, the typical build + progresses as follows: Fetch the source @@ -1406,7 +1407,7 @@ Configure the source - Compiling the source + Compile the source Install the build output @@ -1417,10 +1418,13 @@ For recipes in the workspace, fetching and unpacking is disabled as the source tree has already been prepared and is persistent. - Each of these build steps is defined as a function, usually with a - "do_" prefix. - These functions are typically shell scripts but can instead be written - in Python. + Each of these build steps is defined as a function (task), usually + with a "do_" prefix (e.g. + do_fetch, + do_unpack, + and so forth). + These functions are typically shell scripts but can instead be + written in Python. @@ -1428,12 +1432,13 @@ recipe does not include complete instructions for building the software. Instead, common functionality is encapsulated in classes inherited - with the inherit directive, leaving the recipe - to describe just the things that are specific to the software to be - built. - A base - class exists that is implicitly inherited by all recipes and provides - the functionality that most typical recipes need. + with the inherit directive. + This technique leaves the recipe to describe just the things that + are specific to the software being built. + A + base + class exists that is implicitly inherited by all recipes and + provides the functionality that most recipes typically need.