summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml26
1 files changed, 17 insertions, 9 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 165c3aa6a7..f72f81f551 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -5420,26 +5420,34 @@
5420 <literallayout class='monospaced'> 5420 <literallayout class='monospaced'>
5421 BBMULTICONFIG = "x86 arm" 5421 BBMULTICONFIG = "x86 arm"
5422 </literallayout> 5422 </literallayout>
5423 </para>
5424
5425 <para>Please note, that a "default" configuration already exists by definition,
5426 this configuration is named: "" (empty string) and is defined by the variables
5427 coming from your local.conf file. So, the previous example actually adds two
5428 additional configurations to your build "arm" and "x86" along with "".
5423 </para></listitem> 5429 </para></listitem>
5424 <listitem><para> 5430 <listitem><para>
5425 <emphasis>Launch BitBake</emphasis>: 5431 <emphasis>Launch BitBake</emphasis>:
5426 Use the following BitBake command form to launch the 5432 Use the following BitBake command form to launch the
5427 multiple configuration build: 5433 multiple configuration build:
5428 <literallayout class='monospaced'> 5434 <literallayout class='monospaced'>
5429 $ bitbake [multiconfig:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable> [[[multiconfig:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable>] ... ] 5435 $ bitbake [mc:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable> [[[mc:<replaceable>multiconfigname</replaceable>:]<replaceable>target</replaceable>] ... ]
5430 </literallayout> 5436 </literallayout>
5431 For the example in this section, the following 5437 For the example in this section, the following
5432 command applies: 5438 command applies:
5433 <literallayout class='monospaced'> 5439 <literallayout class='monospaced'>
5434 $ bitbake multiconfig:x86:core-image-minimal multiconfig:arm:core-image-sato 5440 $ bitbake mc:x86:core-image-minimal mc:arm:core-image-sato mc::core-image-base
5435 </literallayout> 5441 </literallayout>
5436 The previous BitBake command builds a 5442 The previous BitBake command builds a
5437 <filename>core-image-minimal</filename> image that 5443 <filename>core-image-minimal</filename> image that
5438 is configured through the 5444 is configured through the
5439 <filename>x86.conf</filename> configuration file 5445 <filename>x86.conf</filename> configuration file,
5440 and builds a <filename>core-image-sato</filename> 5446 a <filename>core-image-sato</filename>
5441 image that is configured through the 5447 image that is configured through the
5442 <filename>arm.conf</filename> configuration file. 5448 <filename>arm.conf</filename> configuration file and a
5449 <filename>core-image-base</filename> that is configured
5450 through your <filename>local.conf</filename> configuration file.
5443 </para></listitem> 5451 </para></listitem>
5444 </itemizedlist> 5452 </itemizedlist>
5445 <note> 5453 <note>
@@ -5479,7 +5487,7 @@
5479 build, you must declare the dependencies in the recipe 5487 build, you must declare the dependencies in the recipe
5480 using the following statement form: 5488 using the following statement form:
5481 <literallayout class='monospaced'> 5489 <literallayout class='monospaced'>
5482 <replaceable>task_or_package</replaceable>[mcdepends] = "multiconfig:<replaceable>from_multiconfig</replaceable>:<replaceable>to_multiconfig</replaceable>:<replaceable>recipe_name</replaceable>:<replaceable>task_on_which_to_depend</replaceable>" 5490 <replaceable>task_or_package</replaceable>[mcdepends] = "mc:<replaceable>from_multiconfig</replaceable>:<replaceable>to_multiconfig</replaceable>:<replaceable>recipe_name</replaceable>:<replaceable>task_on_which_to_depend</replaceable>"
5483 </literallayout> 5491 </literallayout>
5484 To better show how to use this statement, consider the 5492 To better show how to use this statement, consider the
5485 example scenario from the first paragraph of this section. 5493 example scenario from the first paragraph of this section.
@@ -5487,7 +5495,7 @@
5487 that builds the <filename>core-image-sato</filename> 5495 that builds the <filename>core-image-sato</filename>
5488 image: 5496 image:
5489 <literallayout class='monospaced'> 5497 <literallayout class='monospaced'>
5490 do_image[mcdepends] = "multiconfig:x86:arm:core-image-minimal:do_rootfs" 5498 do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_rootfs"
5491 </literallayout> 5499 </literallayout>
5492 In this example, the 5500 In this example, the
5493 <replaceable>from_multiconfig</replaceable> is "x86". 5501 <replaceable>from_multiconfig</replaceable> is "x86".
@@ -5502,7 +5510,7 @@
5502 Once you set up this dependency, you can build the 5510 Once you set up this dependency, you can build the
5503 "x86" multiconfig using a BitBake command as follows: 5511 "x86" multiconfig using a BitBake command as follows:
5504 <literallayout class='monospaced'> 5512 <literallayout class='monospaced'>
5505 $ bitbake multiconfig:x86:core-image-sato 5513 $ bitbake mc:x86:core-image-sato
5506 </literallayout> 5514 </literallayout>
5507 This command executes all the tasks needed to create 5515 This command executes all the tasks needed to create
5508 the <filename>core-image-sato</filename> image for the 5516 the <filename>core-image-sato</filename> image for the
@@ -5518,7 +5526,7 @@
5518 Consider this change to the statement in the 5526 Consider this change to the statement in the
5519 <filename>core-image-sato</filename> recipe: 5527 <filename>core-image-sato</filename> recipe:
5520 <literallayout class='monospaced'> 5528 <literallayout class='monospaced'>
5521 do_image[mcdepends] = "multiconfig:x86:arm:core-image-minimal:do_image" 5529 do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_image"
5522 </literallayout> 5530 </literallayout>
5523 In this case, BitBake must create the 5531 In this case, BitBake must create the
5524 <filename>core-image-minimal</filename> image for the 5532 <filename>core-image-minimal</filename> image for the