summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-11-21 10:14:52 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-12-09 15:09:06 +0000
commit6a57cb10b7ff63884abc6c2b4301d48f29514119 (patch)
tree51f615b6fef64693d7d78f072d85f7c5944c364d /documentation
parent117c9b4a64a4c490b353e31567d0a593bac98a3f (diff)
downloadast2050-yocto-poky-6a57cb10b7ff63884abc6c2b4301d48f29514119.zip
ast2050-yocto-poky-6a57cb10b7ff63884abc6c2b4301d48f29514119.tar.gz
dev-manual: Added more info to mulit-machine builds section.
Fixes [YOCTO #5400] Per Martin Jansa, added some information in the bullet item that talks about the tools and the cases that can cause issues when tuning things by machine or architecture. (From yocto-docs rev: e8e47828df65abdc18bbd681c47719a7df77b00f) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml22
1 files changed, 17 insertions, 5 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 664b294..b894355 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6061,10 +6061,10 @@ Gateways via their Web Interfaces</ulink>"</emphasis>
architecture through the
<ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_ARCH'><filename>PACKAGE_ARCH</filename></ulink>,
The OpenEmbedded build system defaults to the
- <ulink url='&YOCTO_DOCS_REF_URL;#var-TUNE_ARCH'><filename>TUNE_ARCH</filename></ulink>
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-TUNE_PKGARCH'><filename>TUNE_PKGARCH</filename></ulink>
setting:
<literallayout class='monospaced'>
- PACKAGE_ARCH = "${TUNE_ARCH}"
+ PACKAGE_ARCH = "${TUNE_PKGARCH}"
</literallayout>
</para></listitem>
<listitem><para><emphasis>Choose a Generic Tuning File if Possible:</emphasis>
@@ -6117,12 +6117,24 @@ Gateways via their Web Interfaces</ulink>"</emphasis>
using shared state between machines when you think it
should be.
These types of situations are usually due to references
- to variables such as <filename>MACHINE</filename>
- in code that is supposed to only be "tune" specific.</para>
+ to machine-specific variables such as
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-SERIAL_CONSOLE'><filename>SERIAL_CONSOLE</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-XSERVER'><filename>XSERVER</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></ulink>,
+ and so forth in code that is supposed to only be
+ tune-specific or when the recipe depends
+ (<ulink url='&YOCTO_DOCS_REF_URL;#var-DEPENDS'><filename>DEPENDS</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-RDEPENDS'><filename>RDEPENDS</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-RRECOMMENDS'><filename>RRECOMMENDS</filename></ulink>,
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-RSUGGESTS'><filename>RSUGGESTS</filename></ulink>,
+ and so forth) on some other recipe that already has
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_ARCH'><filename>PACKAGE_ARCH</filename></ulink>
+ defined as "${MACHINE_ARCH}".
<note>
Patches to fix any issues identified are most welcome
as these issues occasionally do occur.
- </note>
+ </note></para>
<para>For such cases, you can use some tools to help you
sort out the situation:
<itemizedlist>
OpenPOWER on IntegriCloud