diff options
author | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-07-30 13:47:00 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-08-02 15:44:10 +0100 |
commit | 2d7cf6c056691b6de81bdbb029225d7e0e16f37b (patch) | |
tree | 3c3c0abaa8c1e40946b445de659d4fd339d335de /bitbake/doc/bitbake-user-manual | |
parent | 2abf8a699edd513405befbd1a0eafc8f55d6b514 (diff) | |
download | poky-2d7cf6c056691b6de81bdbb029225d7e0e16f37b.tar.gz |
bitbake: doc/lib: Update to use new override syntax containing colons
This runs the overrides conversion script in OE-Core over the bitbake code
base including the docs. A handful of things were excluded in toaster
and for the Changelog file.
(Bitbake rev: 47f8d3b24fd52381bf3b41e2f55a53e57841344c)
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/doc/bitbake-user-manual')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst | 64 | ||||
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | 14 |
2 files changed, 39 insertions, 39 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 | |||
281 | rather than being immediately applied. Here are some examples:: | 281 | rather 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 | ||
290 | The variable :term:`B` | 290 | The variable :term:`B` |
291 | becomes "bval additional data" and ``C`` becomes "additional data cval". | 291 | becomes "bval additional data" and ``C`` becomes "additional data cval". |
@@ -312,10 +312,10 @@ When you use this syntax, BitBake expects one or more strings. | |||
312 | Surrounding spaces and spacing are preserved. Here is an example:: | 312 | Surrounding 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`` | |||
349 | uses the "_append" operator, then the final value of ``FOO`` will be | 349 | uses 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 | ||
587 | Key Expansion | 587 | Key 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 | ||
623 | For this case, | 623 | For 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 | ||
640 | For this case, before | 640 | For this case, before |
641 | overrides are handled, ``A`` is set to "Z" and ``A_append_foo`` is set | 641 | overrides 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 | ||
654 | For this case, before any overrides are resolved, | 654 | For 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 | |||
661 | This final example mixes in some varying operators:: | 661 | This 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 | ||
978 | As an example, consider the following:: | 978 | As 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 | |||
1139 | up with the value "foo from anonymous":: | 1139 | up 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") |
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index 797e2a00cc..6283c2654c 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | |||
@@ -1118,7 +1118,7 @@ overview of their function and contents. | |||
1118 | attempt before any others by adding something like the following to | 1118 | attempt before any others by adding something like the following to |
1119 | your configuration:: | 1119 | your configuration:: |
1120 | 1120 | ||
1121 | PREMIRRORS_prepend = "\ | 1121 | PREMIRRORS:prepend = "\ |
1122 | git://.*/.* http://www.yoctoproject.org/sources/ \n \ | 1122 | git://.*/.* http://www.yoctoproject.org/sources/ \n \ |
1123 | ftp://.*/.* http://www.yoctoproject.org/sources/ \n \ | 1123 | ftp://.*/.* http://www.yoctoproject.org/sources/ \n \ |
1124 | http://.*/.* http://www.yoctoproject.org/sources/ \n \ | 1124 | http://.*/.* http://www.yoctoproject.org/sources/ \n \ |
@@ -1184,7 +1184,7 @@ overview of their function and contents. | |||
1184 | that depends on the ``perl`` package. In this case, you would use the | 1184 | that depends on the ``perl`` package. In this case, you would use the |
1185 | following :term:`RDEPENDS` statement:: | 1185 | following :term:`RDEPENDS` statement:: |
1186 | 1186 | ||
1187 | RDEPENDS_${PN}-dev += "perl" | 1187 | RDEPENDS:${PN}-dev += "perl" |
1188 | 1188 | ||
1189 | In the example, the development package depends on the ``perl`` package. | 1189 | In the example, the development package depends on the ``perl`` package. |
1190 | Thus, the :term:`RDEPENDS` variable has the ``${PN}-dev`` package name as part | 1190 | Thus, the :term:`RDEPENDS` variable has the ``${PN}-dev`` package name as part |
@@ -1195,7 +1195,7 @@ overview of their function and contents. | |||
1195 | differences from you. Here is the general syntax to specify versions | 1195 | differences from you. Here is the general syntax to specify versions |
1196 | with the :term:`RDEPENDS` variable:: | 1196 | with the :term:`RDEPENDS` variable:: |
1197 | 1197 | ||
1198 | RDEPENDS_${PN} = "package (operator version)" | 1198 | RDEPENDS:${PN} = "package (operator version)" |
1199 | 1199 | ||
1200 | For ``operator``, you can specify the following:: | 1200 | For ``operator``, you can specify the following:: |
1201 | 1201 | ||
@@ -1208,7 +1208,7 @@ overview of their function and contents. | |||
1208 | For example, the following sets up a dependency on version 1.2 or | 1208 | For example, the following sets up a dependency on version 1.2 or |
1209 | greater of the package ``foo``:: | 1209 | greater of the package ``foo``:: |
1210 | 1210 | ||
1211 | RDEPENDS_${PN} = "foo (>= 1.2)" | 1211 | RDEPENDS:${PN} = "foo (>= 1.2)" |
1212 | 1212 | ||
1213 | For information on build-time dependencies, see the :term:`DEPENDS` | 1213 | For information on build-time dependencies, see the :term:`DEPENDS` |
1214 | variable. | 1214 | variable. |
@@ -1237,7 +1237,7 @@ overview of their function and contents. | |||
1237 | variable in conjunction with a package name override. Here is an | 1237 | variable in conjunction with a package name override. Here is an |
1238 | example:: | 1238 | example:: |
1239 | 1239 | ||
1240 | RPROVIDES_${PN} = "widget-abi-2" | 1240 | RPROVIDES:${PN} = "widget-abi-2" |
1241 | 1241 | ||
1242 | :term:`RRECOMMENDS` | 1242 | :term:`RRECOMMENDS` |
1243 | A list of packages that extends the usability of a package being | 1243 | A list of packages that extends the usability of a package being |
@@ -1251,7 +1251,7 @@ overview of their function and contents. | |||
1251 | differences from you. Here is the general syntax to specify versions | 1251 | differences from you. Here is the general syntax to specify versions |
1252 | with the :term:`RRECOMMENDS` variable:: | 1252 | with the :term:`RRECOMMENDS` variable:: |
1253 | 1253 | ||
1254 | RRECOMMENDS_${PN} = "package (operator version)" | 1254 | RRECOMMENDS:${PN} = "package (operator version)" |
1255 | 1255 | ||
1256 | For ``operator``, you can specify the following:: | 1256 | For ``operator``, you can specify the following:: |
1257 | 1257 | ||
@@ -1264,7 +1264,7 @@ overview of their function and contents. | |||
1264 | For example, the following sets up a recommend on version | 1264 | For example, the following sets up a recommend on version |
1265 | 1.2 or greater of the package ``foo``:: | 1265 | 1.2 or greater of the package ``foo``:: |
1266 | 1266 | ||
1267 | RRECOMMENDS_${PN} = "foo (>= 1.2)" | 1267 | RRECOMMENDS:${PN} = "foo (>= 1.2)" |
1268 | 1268 | ||
1269 | :term:`SECTION` | 1269 | :term:`SECTION` |
1270 | The section in which packages should be categorized. | 1270 | The section in which packages should be categorized. |