diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-01-09 09:34:13 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-21 21:57:59 +0000 |
commit | ab001ceb650d7cd918c0c89076fcb21e4cd6f504 (patch) | |
tree | 8a311755eb7e0dda16e3040189501f8111bca6f9 | |
parent | b6c0bae0aa770e8c5a325cb83710c1a5c8fb5017 (diff) | |
download | ast2050-yocto-poky-ab001ceb650d7cd918c0c89076fcb21e4cd6f504.zip ast2050-yocto-poky-ab001ceb650d7cd918c0c89076fcb21e4cd6f504.tar.gz |
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>
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 25 |
1 files changed, 17 insertions, 8 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 329d978..585f4ad 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -1911,18 +1911,18 @@ <title>Installing</title> <para> - During <filename>do_install</filename>, the files and their - structure that your recipe built are copied to locations on the - target device. - The installation process moves the + During <filename>do_install</filename>, the task copies the + built files along with their hierarchy to locations that + would mirror their locations on the target device. + 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-B'><filename>B</filename></ulink><filename>}</filename>, and <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> - to create the structure as it should appear on the target - system. + directory to create the structure as it should appear on the + target system. </para> <para> @@ -1939,6 +1939,12 @@ Consequently, you do not have to have a <filename>do_install</filename> task as part of your 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 build completes with no issues.</para></listitem> <listitem><para><emphasis>Other (using @@ -2003,7 +2009,10 @@ <note> <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. Sometimes, a Makefile can have missing dependencies between targets that can result in race conditions. |