summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml33
1 files changed, 29 insertions, 4 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 8ff0d671d1..d1a31a4bc9 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4025,6 +4025,15 @@
4025 "", you need to set the variable to specify any required 4025 "", you need to set the variable to specify any required
4026 GNU options. 4026 GNU options.
4027 </para> 4027 </para>
4028
4029 <para>
4030 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>
4031 and
4032 <link linkend='var-PARALLEL_MAKEINST'><filename>PARALLEL_MAKEINST</filename></link>
4033 also make use of
4034 <filename>EXTRA_OEMAKE</filename> to pass the required
4035 flags.
4036 </para>
4028 </glossdef> 4037 </glossdef>
4029 </glossentry> 4038 </glossentry>
4030 4039
@@ -9259,6 +9268,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9259 where <replaceable>x</replaceable> represents the maximum 9268 where <replaceable>x</replaceable> represents the maximum
9260 number of parallel threads <filename>make</filename> can 9269 number of parallel threads <filename>make</filename> can
9261 run. 9270 run.
9271 <note><title>Caution</title>
9272 In order for <filename>PARALLEL_MAKE</filename> to be
9273 effective, <filename>make</filename> must be called
9274 with
9275 <filename>${</filename><link linkend='var-EXTRA_OEMAKE'><filename>EXTRA_OEMAKE</filename></link><filename>}</filename>.
9276 An easy way to ensure this is to use the
9277 <filename>oe_runmake</filename> function.
9278 </note>
9262 </para> 9279 </para>
9263 9280
9264 <para> 9281 <para>
@@ -9305,16 +9322,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9305 task in order to specify parallel installation. 9322 task in order to specify parallel installation.
9306 This variable defaults to the value of 9323 This variable defaults to the value of
9307 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>. 9324 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>.
9308 <note> 9325 <note><title>Notes and Cautions</title>
9309 If the software being built experiences dependency 9326 <para>In order for <filename>PARALLEL_MAKEINST</filename>
9310 issues during the 9327 to be
9328 effective, <filename>make</filename> must be called
9329 with
9330 <filename>${</filename><link linkend='var-EXTRA_OEMAKE'><filename>EXTRA_OEMAKE</filename></link><filename>}</filename>.
9331 An easy way to ensure this is to use the
9332 <filename>oe_runmake</filename> function.</para>
9333
9334 <para>If the software being built experiences
9335 dependency issues during the
9311 <filename>do_install</filename> task that result in 9336 <filename>do_install</filename> task that result in
9312 race conditions, you can clear the 9337 race conditions, you can clear the
9313 <filename>PARALLEL_MAKEINST</filename> variable within 9338 <filename>PARALLEL_MAKEINST</filename> variable within
9314 the recipe as a workaround. 9339 the recipe as a workaround.
9315 For information on addressing race conditions, see the 9340 For information on addressing race conditions, see the
9316 "<ulink url='&YOCTO_DOCS_DEV_URL;#debugging-parallel-make-races'>Debugging Parallel Make Races</ulink>" 9341 "<ulink url='&YOCTO_DOCS_DEV_URL;#debugging-parallel-make-races'>Debugging Parallel Make Races</ulink>"
9317 section in the Yocto Project Development Manual. 9342 section in the Yocto Project Development Manual.</para>
9318 </note> 9343 </note>
9319 </para> 9344 </para>
9320 </glossdef> 9345 </glossdef>