mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-23 09:32:17 +02:00
Code Issues Packages Projects Releases Wiki Activity

adt-manual, ref-manual: Cross-toolchain details added. New class also.

Browse Source 
In the adt-manual in the "Optionally Building a Toolchain Installer"
setion, I added some basic advantage information for building a
toolchain installer using bitbake image -c populate_sdk.

In the ref-manual, I added cross-referencing to this basic information
in several strategic areas: "SDK Generation", the populate_sdk class
reference section, the populate_sdk_* class reference section, and the
"Cross-Development Toolchain Generation" sections.

Finally, I also put in documentation for a new class called
autotools-brokensep.

(From yocto-docs rev: cde7dd2fbd7bdc0d71dc678ee7a5422459654287)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2014-03-20 17:52:28 -06:00
committed by Richard Purdie
parent c441f5f005
commit 32890f29af
4 changed files with 93 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
documentation/ref-manual/ref-classes.xml
View File

@@ -130,6 +130,36 @@
</para></listitem>
</itemizedlist>
</para>
<note>
It is planned for future Yocto Project releases that by default, the
<filename>autotools</filename> class supports out-of-tree builds
(<link linkend='var-B'><filename>B</filename></link> !=
<link linkend='var-S'><filename>S</filename></link>).
If your recipes do not support out-of-tree builds, you should
have them inherit the
<link linkend='ref-classes-autotools-brokensep'><filename>autotools-brokensep</filename></link>
class.
</note>
</section>
<section id='ref-classes-autotools-brokensep'>
<title><filename>autotools-brokensep.bbclass</filename></title>
<para>
The <filename>autotools-brokensep</filename> class behaves the same
as the
<link linkend='ref-classes-autotools'><filename>autotools</filename></link>
class but builds with
<link linkend='var-B'><filename>B</filename></link> ==
<link linkend='var-S'><filename>S</filename></link>.
This method is useful when out-of-tree build support is either not
present or is broken.
<note>
It is recommended that out-of-tree support be fixed and used
if at all possible.
</note>
</para>
</section>
<section id='ref-classes-base'>
@@ -2220,6 +2250,10 @@
<para>
The <filename>populate_sdk</filename> class provides support for
SDK-only recipes.
For information on advantages gained when building a cross-development
toolchain using the <filename>do_populate_sdk</filename> task, see the
"<ulink url='&YOCTO_DOCS_ADT_URL;#optionally-building-a-toolchain-installer'>Optionally Building a Toolchain Installer</ulink>"
section in the Yocto Project Application Developer's Guide.
</para>
</section>
@@ -2284,6 +2318,18 @@
These classes are inherited by and used with the
<filename>populate_sdk_base</filename> class.
</para>
<para>
For more information on the cross-development toolchain
generation, see the
"<link linkend='cross-development-toolchain-generation'>Cross-Development Toolchain Generation</link>"
section.
For information on advantages gained when building a
cross-development toolchain using the
<filename>do_populate_sdk</filename> task, see the
"<ulink url='&YOCTO_DOCS_ADT_URL;#optionally-building-a-toolchain-installer'>Optionally Building a Toolchain Installer</ulink>"
section in the Yocto Project Application Developer's Guide.
</para>
</section>
<section id='ref-classes-prexport'>