[oe-commits] [bitbake] 04/09: bitbake-user-manual: Updated the "Inline Python Variable Expansion" section.

[git at git.openembedded.org]

rpurdie pushed a commit to branch master
in repository bitbake.

commit 64bf49826088c56b739ed971251f05b4564c712e
Author: Scott Rifenbark <srifenbark at gmail.com>
AuthorDate: Thu Jul 21 11:02:52 2016 -0700

    bitbake-user-manual: Updated the "Inline Python Variable Expansion" section.
    
    Fixes [YOCTO #9984]
    
    Added a small note to the bottom to help clarify.
    
    Signed-off-by: Scott Rifenbark <srifenbark at gmail.com>
---
 .../bitbake-user-manual-metadata.xml                    | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index 436abd5..f7b541d 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -316,7 +316,7 @@
                 </literallayout>
                 <note>
                     It is never necessary to use "+=" together with "_append".
-                    The following sequence of assignments appepnds "barbaz" to
+                    The following sequence of assignments appends "barbaz" to
                     <filename>FOO</filename>:
                     <literallayout class='monospaced'>
      FOO_append = "bar"
@@ -401,6 +401,21 @@
      PN = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[0] or 'defaultpkgname'}"
      PV = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[1] or '1.0'}"
                 </literallayout>
+                <note>
+                    Inline Python expressions work just like variable expansions
+                    insofar as the "=" and ":=" operators are concerned.
+                    Given the following assignment, <filename>foo()</filename>
+                    is called each time <filename>FOO</filename> is expanded:
+                    <literallayout class='monospaced'>
+     FOO = "${@foo()}"
+                    </literallayout>
+                    Contrast this with the following immediate assignment, where
+                    <filename>foo()</filename> is only called once, while the
+                    assignment is parsed:
+                    <literallayout class='monospaced'>
+     FOO := "${@foo()}"
+                    </literallayout>
+                </note>
             </para>
         </section>
 

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.