mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-01 13:09:50 +00:00
Code Issues Projects Releases Wiki Activity

sdk-manual: Added links to sample tasks to "Working With Recipes"

Browse Source 
(From yocto-docs rev: 6dd62a3f97dc4e70a532faae0055ef7937f40afc)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-05-31 11:10:40 -07:00
committed by Richard Purdie
parent 6068e017e8
commit 815d829600
1 changed files with 18 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/sdk-manual/sdk-extensible.xml
+18 -13
View File
@@ -1393,8 +1393,9 @@
<title>Working With Recipes</title> <title>Working With Recipes</title>
<para> <para>
When building a recipe with <filename>devtool build</filename>, the When building a recipe using the
typical build progression is as follows: <filename>devtool build</filename> command, the typical build
progresses as follows:
<orderedlist> <orderedlist>
<listitem><para> <listitem><para>
Fetch the source Fetch the source
@@ -1406,7 +1407,7 @@
Configure the source Configure the source
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
Compiling the source Compile the source
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
Install the build output Install the build output
@@ -1417,10 +1418,13 @@
</orderedlist> </orderedlist>
For recipes in the workspace, fetching and unpacking is disabled For recipes in the workspace, fetching and unpacking is disabled
as the source tree has already been prepared and is persistent. as the source tree has already been prepared and is persistent.
Each of these build steps is defined as a function, usually with a Each of these build steps is defined as a function (task), usually
"do_" prefix. with a "do_" prefix (e.g.
These functions are typically shell scripts but can instead be written <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-fetch'><filename>do_fetch</filename></ulink>,
in Python. <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-unpack'><filename>do_unpack</filename></ulink>,
and so forth).
These functions are typically shell scripts but can instead be
written in Python.
</para> </para>
<para> <para>
@@ -1428,12 +1432,13 @@
recipe does not include complete instructions for building the recipe does not include complete instructions for building the
software. software.
Instead, common functionality is encapsulated in classes inherited Instead, common functionality is encapsulated in classes inherited
with the <filename>inherit</filename> directive, leaving the recipe with the <filename>inherit</filename> directive.
to describe just the things that are specific to the software to be This technique leaves the recipe to describe just the things that
built. are specific to the software being built.
A <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-base'><filename>base</filename></ulink> A
class exists that is implicitly inherited by all recipes and provides <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-base'><filename>base</filename></ulink>
the functionality that most typical recipes need. class exists that is implicitly inherited by all recipes and
provides the functionality that most recipes typically need.
</para> </para>
<para> <para>