diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-10-10 11:48:03 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-10-13 23:29:25 +0100 |
commit | eedb264387e87e43a51117fbc539993f3aea5bf3 (patch) | |
tree | c79acfd52d23645f18a92048ac24864373157a4a /bitbake | |
parent | b2f1d21ff3d0e2f1f152a208394741dad789a623 (diff) | |
download | openembedded-core-contrib-eedb264387e87e43a51117fbc539993f3aea5bf3.tar.gz |
bitbake: bitbake-user-manual: Updated the datastore functions
Fixes [YOCTO #10400]
No information existed for cases when a variable did not exist.
I added this information to each of the variables in the table.
(Bitbake rev: 466b2c30f31754a7b6a2478e359f687ec6888e0d)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 44 |
1 files changed, 32 insertions, 12 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 53e182ba61..40f4829e6a 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml @@ -2317,7 +2317,8 @@ <row> <entry align="left"><filename>d.getVar("X", expand)</filename></entry> <entry align="left">Returns the value of variable "X". - Using "expand=True" expands the value.</entry> + Using "expand=True" expands the value. + Returns "None" if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.setVar("X", "value")</filename></entry> @@ -2325,24 +2326,32 @@ </row> <row> <entry align="left"><filename>d.appendVar("X", "value")</filename></entry> - <entry align="left">Adds "value" to the end of the variable "X".</entry> + <entry align="left">Adds "value" to the end of the variable "X". + Acts like <filename>d.setVar("X", "value")</filename> + if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.prependVar("X", "value")</filename></entry> - <entry align="left">Adds "value" to the start of the variable "X".</entry> + <entry align="left">Adds "value" to the start of the variable "X". + Acts like <filename>d.setVar("X", "value")</filename> + if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.delVar("X")</filename></entry> - <entry align="left">Deletes the variable "X" from the datastore.</entry> + <entry align="left">Deletes the variable "X" from the datastore. + Does nothing if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.renameVar("X", "Y")</filename></entry> - <entry align="left">Renames the variable "X" to "Y".</entry> + <entry align="left">Renames the variable "X" to "Y". + Does nothing if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.getVarFlag("X", flag, expand)</filename></entry> <entry align="left">Returns the value of variable "X". - Using "expand=True" expands the value.</entry> + Using "expand=True" expands the value. + Returns "None" if either the variable "X" or the named flag + does not exist.</entry> </row> <row> <entry align="left"><filename>d.setVarFlag("X", flag, "value")</filename></entry> @@ -2351,12 +2360,16 @@ <row> <entry align="left"><filename>d.appendVarFlag("X", flag, "value")</filename></entry> <entry align="left">Appends "value" to the named flag on the - variable "X".</entry> + variable "X". + Acts like <filename>d.setVarFlag("X", flag, "value")</filename> + if the named flag does not exist.</entry> </row> <row> <entry align="left"><filename>d.prependVarFlag("X", flag, "value")</filename></entry> <entry align="left">Prepends "value" to the named flag on - the variable "X".</entry> + the variable "X". + Acts like <filename>d.setVarFlag("X", flag, "value")</filename> + if the named flag does not exist.</entry> </row> <row> <entry align="left"><filename>d.delVarFlag("X", flag)</filename></entry> @@ -2372,16 +2385,23 @@ </row> <row> <entry align="left"><filename>d.getVarFlags("X")</filename></entry> - <entry align="left">Returns a <filename>flagsdict</filename> of the flags for - the variable "X".</entry> + <entry align="left">Returns a <filename>flagsdict</filename> + of the flags for the variable "X". + Returns "None" if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.delVarFlags("X")</filename></entry> - <entry align="left">Deletes all the flags for the variable "X".</entry> + <entry align="left">Deletes all the flags for the variable "X". + Does nothing if the variable "X" does not exist.</entry> </row> <row> <entry align="left"><filename>d.expand(expression)</filename></entry> - <entry align="left">Expands variable references in the specified string expression.</entry> + <entry align="left">Expands variable references in the specified + string expression. + References to variables that do not exist are left as is. + For example, <filename>d.expand("foo ${X}")</filename> + expands to the literal string "foo ${X}" if the + variable "X" does not exist.</entry> </row> </tbody> </tgroup> |