summaryrefslogtreecommitdiffstats
path: root/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
diff options
context:
space:
mode:
Diffstat (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst64
1 files changed, 32 insertions, 32 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
index 3e14163ebe..db44e26fbd 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
@@ -281,11 +281,11 @@ operators in that their effects are applied at variable expansion time
281rather than being immediately applied. Here are some examples:: 281rather than being immediately applied. Here are some examples::
282 282
283 B = "bval" 283 B = "bval"
284 B_append = " additional data" 284 B:append = " additional data"
285 C = "cval" 285 C = "cval"
286 C_prepend = "additional data " 286 C:prepend = "additional data "
287 D = "dval" 287 D = "dval"
288 D_append = "additional data" 288 D:append = "additional data"
289 289
290The variable :term:`B` 290The variable :term:`B`
291becomes "bval additional data" and ``C`` becomes "additional data cval". 291becomes "bval additional data" and ``C`` becomes "additional data cval".
@@ -312,10 +312,10 @@ When you use this syntax, BitBake expects one or more strings.
312Surrounding spaces and spacing are preserved. Here is an example:: 312Surrounding spaces and spacing are preserved. Here is an example::
313 313
314 FOO = "123 456 789 123456 123 456 123 456" 314 FOO = "123 456 789 123456 123 456 123 456"
315 FOO_remove = "123" 315 FOO:remove = "123"
316 FOO_remove = "456" 316 FOO:remove = "456"
317 FOO2 = " abc def ghi abcdef abc def abc def def" 317 FOO2 = " abc def ghi abcdef abc def abc def def"
318 FOO2_remove = "\ 318 FOO2:remove = "\
319 def \ 319 def \
320 abc \ 320 abc \
321 ghi \ 321 ghi \
@@ -349,15 +349,15 @@ If, on the other hand, ``foo.bbclass``
349uses the "_append" operator, then the final value of ``FOO`` will be 349uses the "_append" operator, then the final value of ``FOO`` will be
350"initial val", as intended:: 350"initial val", as intended::
351 351
352 FOO_append = " val" 352 FOO:append = " val"
353 353
354.. note:: 354.. note::
355 355
356 It is never necessary to use "+=" together with "_append". The following 356 It is never necessary to use "+=" together with "_append". The following
357 sequence of assignments appends "barbaz" to FOO:: 357 sequence of assignments appends "barbaz" to FOO::
358 358
359 FOO_append = "bar" 359 FOO:append = "bar"
360 FOO_append = "baz" 360 FOO:append = "baz"
361 361
362 362
363 The only effect of changing the second assignment in the previous 363 The only effect of changing the second assignment in the previous
@@ -538,12 +538,12 @@ variable.
538 that value based on the architecture of the build:: 538 that value based on the architecture of the build::
539 539
540 KBRANCH = "standard/base" 540 KBRANCH = "standard/base"
541 KBRANCH_qemuarm = "standard/arm-versatile-926ejs" 541 KBRANCH:qemuarm = "standard/arm-versatile-926ejs"
542 KBRANCH_qemumips = "standard/mti-malta32" 542 KBRANCH:qemumips = "standard/mti-malta32"
543 KBRANCH_qemuppc = "standard/qemuppc" 543 KBRANCH:qemuppc = "standard/qemuppc"
544 KBRANCH_qemux86 = "standard/common-pc/base" 544 KBRANCH:qemux86 = "standard/common-pc/base"
545 KBRANCH_qemux86-64 = "standard/common-pc-64/base" 545 KBRANCH:qemux86-64 = "standard/common-pc-64/base"
546 KBRANCH_qemumips64 = "standard/mti-malta64" 546 KBRANCH:qemumips64 = "standard/mti-malta64"
547 547
548- *Appending and Prepending:* BitBake also supports append and prepend 548- *Appending and Prepending:* BitBake also supports append and prepend
549 operations to variable values based on whether a specific item is 549 operations to variable values based on whether a specific item is
@@ -551,7 +551,7 @@ variable.
551 551
552 DEPENDS = "glibc ncurses" 552 DEPENDS = "glibc ncurses"
553 OVERRIDES = "machine:local" 553 OVERRIDES = "machine:local"
554 DEPENDS_append_machine = "libmad" 554 DEPENDS:append_machine = "libmad"
555 555
556 In this example, :term:`DEPENDS` becomes "glibc ncurses libmad". 556 In this example, :term:`DEPENDS` becomes "glibc ncurses libmad".
557 557
@@ -559,15 +559,15 @@ variable.
559 example, the following lines will conditionally append to the 559 example, the following lines will conditionally append to the
560 ``KERNEL_FEATURES`` variable based on the architecture:: 560 ``KERNEL_FEATURES`` variable based on the architecture::
561 561
562 KERNEL_FEATURES_append = " ${KERNEL_EXTRA_FEATURES}" 562 KERNEL_FEATURES:append = " ${KERNEL_EXTRA_FEATURES}"
563 KERNEL_FEATURES_append_qemux86=" cfg/sound.scc cfg/paravirt_kvm.scc" 563 KERNEL_FEATURES:append:qemux86=" cfg/sound.scc cfg/paravirt_kvm.scc"
564 KERNEL_FEATURES_append_qemux86-64=" cfg/sound.scc cfg/paravirt_kvm.scc" 564 KERNEL_FEATURES:append:qemux86-64=" cfg/sound.scc cfg/paravirt_kvm.scc"
565 565
566- *Setting a Variable for a Single Task:* BitBake supports setting a 566- *Setting a Variable for a Single Task:* BitBake supports setting a
567 variable just for the duration of a single task. Here is an example:: 567 variable just for the duration of a single task. Here is an example::
568 568
569 FOO_task-configure = "val 1" 569 FOO_task-configure = "val 1"
570 FOO_task-compile = "val 2" 570 FOO:task-compile = "val 2"
571 571
572 In the 572 In the
573 previous example, ``FOO`` has the value "val 1" while the 573 previous example, ``FOO`` has the value "val 1" while the
@@ -582,7 +582,7 @@ variable.
582 You can also use this syntax with other combinations (e.g. 582 You can also use this syntax with other combinations (e.g.
583 "``_prepend``") as shown in the following example:: 583 "``_prepend``") as shown in the following example::
584 584
585 EXTRA_OEMAKE_prepend_task-compile = "${PARALLEL_MAKE} " 585 EXTRA_OEMAKE:prepend:task-compile = "${PARALLEL_MAKE} "
586 586
587Key Expansion 587Key Expansion
588------------- 588-------------
@@ -618,7 +618,7 @@ example::
618 618
619 OVERRIDES = "foo" 619 OVERRIDES = "foo"
620 A = "Z" 620 A = "Z"
621 A_foo_append = "X" 621 A_foo:append = "X"
622 622
623For this case, 623For this case,
624``A`` is unconditionally set to "Z" and "X" is unconditionally and 624``A`` is unconditionally set to "Z" and "X" is unconditionally and
@@ -635,7 +635,7 @@ This next example changes the order of the override and the append::
635 635
636 OVERRIDES = "foo" 636 OVERRIDES = "foo"
637 A = "Z" 637 A = "Z"
638 A_append_foo = "X" 638 A:append_foo = "X"
639 639
640For this case, before 640For this case, before
641overrides are handled, ``A`` is set to "Z" and ``A_append_foo`` is set 641overrides are handled, ``A`` is set to "Z" and ``A_append_foo`` is set
@@ -648,8 +648,8 @@ back as in the first example::
648 648
649 OVERRIDES = "foo" 649 OVERRIDES = "foo"
650 A = "Y" 650 A = "Y"
651 A_foo_append = "Z" 651 A_foo:append = "Z"
652 A_foo_append = "X" 652 A_foo:append = "X"
653 653
654For this case, before any overrides are resolved, 654For this case, before any overrides are resolved,
655``A`` is set to "Y" using an immediate assignment. After this immediate 655``A`` is set to "Y" using an immediate assignment. After this immediate
@@ -661,8 +661,8 @@ leaving the variable set to "ZX". Finally, applying the override for
661This final example mixes in some varying operators:: 661This final example mixes in some varying operators::
662 662
663 A = "1" 663 A = "1"
664 A_append = "2" 664 A:append = "2"
665 A_append = "3" 665 A:append = "3"
666 A += "4" 666 A += "4"
667 A .= "5" 667 A .= "5"
668 668
@@ -919,7 +919,7 @@ As an example, consider the following::
919 fn 919 fn
920 } 920 }
921 921
922 fn_prepend() { 922 fn:prepend() {
923 bbplain second 923 bbplain second
924 } 924 }
925 925
@@ -927,7 +927,7 @@ As an example, consider the following::
927 bbplain third 927 bbplain third
928 } 928 }
929 929
930 do_foo_append() { 930 do_foo:append() {
931 bbplain fourth 931 bbplain fourth
932 } 932 }
933 933
@@ -977,7 +977,7 @@ override-style operators to BitBake-style Python functions.
977 977
978As an example, consider the following:: 978As an example, consider the following::
979 979
980 python do_foo_prepend() { 980 python do_foo:prepend() {
981 bb.plain("first") 981 bb.plain("first")
982 } 982 }
983 983
@@ -985,7 +985,7 @@ As an example, consider the following::
985 bb.plain("second") 985 bb.plain("second")
986 } 986 }
987 987
988 python do_foo_append() { 988 python do_foo:append() {
989 bb.plain("third") 989 bb.plain("third")
990 } 990 }
991 991
@@ -1139,7 +1139,7 @@ before anonymous functions run. In the following example, ``FOO`` ends
1139up with the value "foo from anonymous":: 1139up with the value "foo from anonymous"::
1140 1140
1141 FOO = "foo" 1141 FOO = "foo"
1142 FOO_append = " from outside" 1142 FOO:append = " from outside"
1143 1143
1144 python () { 1144 python () {
1145 d.setVar("FOO", "foo from anonymous") 1145 d.setVar("FOO", "foo from anonymous")