aboutsummaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorAndre Draszik <adraszik@digisoft.tv>2015-10-21 23:10:52 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-10-21 23:11:12 +0100
commit7d30d67b26f0d2408540c7bb820e47ce8815d546 (patch)
tree56b077358bef61b89bd8e583c23f0199837378e3 /documentation
parenta8674ae642945e8c165dba94bccb004b939bca58 (diff)
downloadopenembedded-core-contrib-7d30d67b26f0d2408540c7bb820e47ce8815d546.tar.gz
ref-manual: Updated the allarch class description.
Added a patch to include a note from Andre. Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/ref-classes.xml26
1 files changed, 14 insertions, 12 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 46e7b79e75..cf77068e73 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -52,20 +52,22 @@
and a C library as pre-requisites, and splitting out of debug symbols
during packaging).
<note>
- Unlike e.g. Debian, OpenEmbedded recipes that produce packages
- which
+ <para>Unlike some distro recipes (e.g. Debian), OpenEmbedded recipes
+ that produce packages that depend on tunings through use of the
<link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>
- on
+ and
<link linkend='var-TUNE_PKGARCH'><filename>TUNE_PKGARCH</filename></link>
- packages should never be made <filename>allarch</filename>, even
- if they do not produce architecture-specific output. This would
- cause the do_package_write_* tasks to have different signatures
- for
- <link linkend='var-MACHINE'><filename>MACHINE</filename></link>s
- with different
- <link linkend='var-TUNE_PKGARCH'><filename>TUNE_PKGARCH</filename></link>,
- thus unnecessary rebuilds every single time an image for a different
- MACHINE is built (even without any change to the recipe).
+ variables, should never be configured for all architectures
+ using <filename>allarch</filename>.
+ This is the case even if the recipes do not produce
+ architecture-specific output.</para>
+ <para>Configuring such recipes for all architectures causes the
+ <link linkend='ref-tasks-package_write_deb'><filename>do_package_write_*</filename></link>
+ tasks to have different signatures for the machines with different
+ tunings.
+ Additionally, unnecessary rebuilds occur every time an
+ image for a different <filename>MACHINE</filename> is built
+ even when the recipe never changes.</para>
</note>
</para>