Skip to contentSkip to conversation

bitbake-user-manual: Correct description of the ??= operator

PATCH Superseded Jacob Kroon 2 participants 2 messages Jun 3, 2022 – Jun 10, 2022

v2 of 5 Superseded Latest is v5 →

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 bitbake-user-manual: Correct description of the ??= operator

---

Changes in v2:
* Add comment to line with immediate variable expansion

 .../bitbake-user-manual-metadata.rst          | 31 +++++++++----------
 1 file changed, 15 insertions(+), 16 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +15 -16
index af4b1358..cfe46562 100644
@@ -195,22 +195,21 @@ value. However, if ``A`` is not set, the variable is set to "aval".
 Setting a weak default value (??=)
 ----------------------------------
 
-It is possible to use a "weaker" assignment than in the previous section
-by using the "??=" operator. This assignment behaves identical to "?="
-except that the assignment is made at the end of the parsing process
-rather than immediately. Consequently, when multiple "??=" assignments
-exist, the last one is used. Also, any "=" or "?=" assignment will
-override the value set with "??=". Here is an example::
-
-   A ??= "somevalue"
-   A ??= "someothervalue"
-
-If ``A`` is set before the above statements are
-parsed, the variable retains its value. If ``A`` is not set, the
-variable is set to "someothervalue".
-
-Again, this assignment is a "lazy" or "weak" assignment because it does
-not occur until the end of the parsing process.
+The weak default value of a variable is the value which that variable
+will expand to if no value has been assigned to it via one of the other
+assignment operators. Here is an example::
+
+   W ??= "x"
+   A := "${W}" # Immediate variable expansion
+   W ??= "y"
+   B = "${W}"
+   W ?= "z"
+
+After parsing we will have::
+
+   A = "x"
+   B = "z"
+   W = "z"
 
 Immediate variable expansion (:=)
 ---------------------------------
#1 lore raw

Hi Jacob

Many thanks for this update to the BitBake manual.

Quoted 5 lines · Jacob Kroon

---

Changes in v2:
* Add comment to line with immediate variable expansion

Would it also possible to mention what was wrong in the previous description?
The fact that the assignment is made at the end of the parsing process, which isn't correct given the example that you give? Otherwise, A := "${W}" wouldn't work, right?

Quoted 21 lines
  .../bitbake-user-manual-metadata.rst          | 31 +++++++++----------
  1 file changed, 15 insertions(+), 16 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +0 -9
index af4b1358..cfe46562 100644
@@ -195,22 +195,21 @@ value. However, if ``A`` is not set, the variable is set to "aval".
  Setting a weak default value (??=)
  ----------------------------------
 
-It is possible to use a "weaker" assignment than in the previous section
-by using the "??=" operator. This assignment behaves identical to "?="
-except that the assignment is made at the end of the parsing process
-rather than immediately. Consequently, when multiple "??=" assignments
-exist, the last one is used. Also, any "=" or "?=" assignment will
-override the value set with "??=". Here is an example::
-
-   A ??= "somevalue"
-   A ??= "someothervalue"

doc/bitbake-user-manual/bitbake-user-manual-metadata.rst value. However, if ``A`` is not set, the variable is set to "aval". · line 200

Quoted 10 lines
doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +3 -7
-
-If ``A`` is set before the above statements are
-parsed, the variable retains its value. If ``A`` is not set, the
-variable is set to "someothervalue".
-
-Again, this assignment is a "lazy" or "weak" assignment because it does
-not occur until the end of the parsing process.
+The weak default value of a variable is the value which that variable
+will expand to if no value has been assigned to it via one of the other
+assignment operators. Here is an example::

Shouldn't we say "via any of the other assignment operators" instead? It would sound a little better to me.

Thanks again
Michael

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com