diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 4a58a6f490..6ae7730f81 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1400,8 +1400,13 @@
Understanding Recipe Syntax
- The basic items that make up a BitBake recipe file are
- as follows:
+ Understanding recipe file syntax is important for
+ writing recipes.
+ The following list overviews the basic items that make up a
+ BitBake recipe file.
+ For more complete BitBake syntax descriptions, see the
+ "Syntax and Operators"
+ chapter of the BitBake User Manual.
Variable Assignments and Manipulations:
Variable assignments allow a value to be assigned to a
@@ -1519,18 +1524,16 @@
local.conf file for variables
that are allowed to come through from the external
environment.
- Doing so allows you to actually set variables from
- the external environment that would otherwise be
- overwritten.
- Here is an example:
+
+ Here is an example where
+ VAR1 is set to "New value" if
+ it is currently empty.
+ However, if VAR1 has already been
+ set, it remains unchanged:
VAR1 ?= "New value"
- In the previous example, VAR1 is
- set to "New value" if it is currently empty.
- However, if VAR1 has already been
- set, it remains unchanged.
- In this next example, VAR1
+ In this next example, VAR1
is left with the value "Original value":
VAR1 = "Original value"
@@ -1632,7 +1635,7 @@
Shell Function Syntax:
- Use shell function syntax as if you were writing a shell
+ Write shell functions as if you were writing a shell
script when you describe a list of actions to take.
You should ensure that your script works with a generic
sh and that it does not require