diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-12-05 15:54:08 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-12-11 14:19:27 +0000 |
commit | 79ba3e4561099fc905a389c9853d1fec0f2db251 (patch) | |
tree | 1df89cfb90c10be1207aac28e84b33f8a286f393 /documentation | |
parent | de7ead9cfdf8275edb99d7940514e68acdfd1388 (diff) | |
download | ast2050-yocto-poky-79ba3e4561099fc905a389c9853d1fec0f2db251.zip ast2050-yocto-poky-79ba3e4561099fc905a389c9853d1fec0f2db251.tar.gz |
ref-manual: Re-ordered externalsrc class into the "C"'s
(From yocto-docs rev: 4b655fbc4abd9ae4a6280346b057b54e99be9d84)
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/ref-manual/ref-classes.xml | 106 |
1 files changed, 53 insertions, 53 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index be68fce..e631c0c 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -585,6 +585,59 @@ </para> </section> +<section id='ref-classes-externalsrc'> + <title><filename>externalsrc.bbclass</filename></title> + + <para> + The <filename>externalsrc</filename> class supports building software + from source code that is external to the OpenEmbedded build system. + Building software from an external source tree means that the build + system's normal fetch, unpack, and patch process is not used. + </para> + + <para> + By default, the OpenEmbedded build system uses the + <link linkend='var-S'><filename>S</filename></link> and + <link linkend='var-B'><filename>B</filename></link> variables to + locate unpacked recipe source code and to build it, respectively. + When your recipe inherits the <filename>externalsrc</filename> class, + you use the + <link linkend='var-EXTERNALSRC'><filename>EXTERNALSRC</filename></link> + and + <link linkend='var-EXTERNALSRC_BUILD'><filename>EXTERNALSRC_BUILD</filename></link> + variables to ultimately define <filename>S</filename> and + <filename>B</filename>. + </para> + + <para> + By default, this class expects the source code to support recipe builds + that use the <link linkend='var-B'><filename>B</filename></link> + variable to point to the directory in which the OpenEmbedded build + system places the generated objects built from the recipes. + By default, the <filename>B</filename> directory is set to the + following, which is separate from the source directory + (<filename>S</filename>): + <literallayout class='monospaced'> + ${WORKDIR}/${BPN}/{PV}/ + </literallayout> + See these variables for more information: + <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>, + <link linkend='var-BPN'><filename>BPN</filename></link>, and + <link linkend='var-PV'><filename>PV</filename></link>, + </para> + + <para> + For more information on the + <filename>externalsrc</filename> class, see the comments in + <filename>meta/classes/externalsrc.bbclass</filename> in the + <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. + For information on how to use the <filename>externalsrc</filename> + class, see the + "<ulink url='&YOCTO_DOCS_DEV_URL;#building-software-from-an-external-source'>Building Software from an External Source</ulink>" + section in the Yocto Project Development Manual. + </para> +</section> + <section id='ref-classes-extrausers'> <title><filename>extrausers.bbclass</filename></title> @@ -2846,59 +2899,6 @@ </para> </section> -<section id='ref-classes-externalsrc'> - <title><filename>externalsrc.bbclass</filename></title> - - <para> - The <filename>externalsrc</filename> class supports building software - from source code that is external to the OpenEmbedded build system. - Building software from an external source tree means that the build - system's normal fetch, unpack, and patch process is not used. - </para> - - <para> - By default, the OpenEmbedded build system uses the - <link linkend='var-S'><filename>S</filename></link> and - <link linkend='var-B'><filename>B</filename></link> variables to - locate unpacked recipe source code and to build it, respectively. - When your recipe inherits the <filename>externalsrc</filename> class, - you use the - <link linkend='var-EXTERNALSRC'><filename>EXTERNALSRC</filename></link> - and - <link linkend='var-EXTERNALSRC_BUILD'><filename>EXTERNALSRC_BUILD</filename></link> - variables to ultimately define <filename>S</filename> and - <filename>B</filename>. - </para> - - <para> - By default, this class expects the source code to support recipe builds - that use the <link linkend='var-B'><filename>B</filename></link> - variable to point to the directory in which the OpenEmbedded build - system places the generated objects built from the recipes. - By default, the <filename>B</filename> directory is set to the - following, which is separate from the source directory - (<filename>S</filename>): - <literallayout class='monospaced'> - ${WORKDIR}/${BPN}/{PV}/ - </literallayout> - See these variables for more information: - <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>, - <link linkend='var-BPN'><filename>BPN</filename></link>, and - <link linkend='var-PV'><filename>PV</filename></link>, - </para> - - <para> - For more information on the - <filename>externalsrc</filename> class, see the comments in - <filename>meta/classes/externalsrc.bbclass</filename> in the - <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. - For information on how to use the <filename>externalsrc</filename> - class, see the - "<ulink url='&YOCTO_DOCS_DEV_URL;#building-software-from-an-external-source'>Building Software from an External Source</ulink>" - section in the Yocto Project Development Manual. - </para> -</section> - <section id='ref-classes-others'> <title>Other Classes</title> |