sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Edits to "Installing" section. 

Applied review comments from Paul Eggleton to this section that is
part of the new "Writing a New Recipe" section.  Minor edits.

(From yocto-docs rev: a5116900ca42377c3dc19433b2f6046828ad2dcc)

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-01-09 09:34:13 -06:00 committed by Richard Purdie
parent b6c0bae0aa
commit ab001ceb65
1 changed files with 17 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -1911,18 +1911,18 @@
<title>Installing</title> <title>Installing</title>
<para> <para>
During <filename>do_install</filename>, the files and their During <filename>do_install</filename>, the task copies the
structure that your recipe built are copied to locations on the built files along with their hierarchy to locations that
target device. would mirror their locations on the target device.
The installation process moves the The installation process copies files from the
<filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename>, <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename>,
<filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink><filename>}</filename>, <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink><filename>}</filename>,
and and
<filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename> <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename>
to the directories to the
<filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename> <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename>
to create the structure as it should appear on the target directory to create the structure as it should appear on the
system. target system.
</para> </para>
<para> <para>
@ -1939,6 +1939,12 @@
Consequently, you do not have to have a Consequently, you do not have to have a
<filename>do_install</filename> task as part of your <filename>do_install</filename> task as part of your
recipe. recipe.
However, if you wish to install additional files not
already being installed by
<filename>make install</filename>, you should do this
using a <filename>do_install_append</filename> function
using the install command as described in
<emphasis>Manual</emphasis> later in this list.
You just need to make sure the install portion of the You just need to make sure the install portion of the
build completes with no issues.</para></listitem> build completes with no issues.</para></listitem>
<listitem><para><emphasis>Other (using <listitem><para><emphasis>Other (using
@ -2003,7 +2009,10 @@
<note> <note>
<filename>oe_runmake install</filename>, which can be run <filename>oe_runmake install</filename>, which can be run
directly or can be run indirectly by the autotools and CMake directly or can be run indirectly by the
<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink>
and
<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink>
classes, runs make install in parallel. classes, runs make install in parallel.
Sometimes, a Makefile can have missing dependencies between Sometimes, a Makefile can have missing dependencies between
targets that can result in race conditions. targets that can result in race conditions.