diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-02-23 09:18:08 -0800 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-03-03 17:34:14 +0000 |
commit | 638ad177aa4e36636113bc1c1608085380d264ce (patch) | |
tree | 1014db1188d252d0b5f51fbc10f404bc72ced86e /bitbake/doc | |
parent | da22add33b8f44ff3019ee9edd7a520b54769c27 (diff) | |
download | openembedded-core-contrib-638ad177aa4e36636113bc1c1608085380d264ce.tar.gz |
bitbake: bitbake-user-manual: Added note for Python variable ref expansion.
Fixes [YOCTO #9148]
Added a note about Variable expressions (e.g. ${X}) are no longer
expanded within Python functions.
(Bitbake rev: 4ebe55cb8c8db1c5cf5d127e213487c5a453a68a)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/doc')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml index cfa85b379a..359df8f75f 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml @@ -840,6 +840,18 @@ is a global variable and is always automatically available. </para> + + <note> + Variable expressions (e.g. <filename>${X}</filename>) are no + longer expanded within Python functions. + This behavior is intentional in order to allow you to freely + set variable values to expandable expressions without having + them expanded prematurely. + If you do wish to expand a variable within a Python function, + use <filename>d.getVar("X", True)</filename>. + Or, for more complicated expressions, use + <filename>d.expand()</filename>. + </note> </section> <section id='python-functions'> |