summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-01-09 09:34:13 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-01-21 21:57:59 +0000
commitab001ceb650d7cd918c0c89076fcb21e4cd6f504 (patch)
tree8a311755eb7e0dda16e3040189501f8111bca6f9
parentb6c0bae0aa770e8c5a325cb83710c1a5c8fb5017 (diff)
downloadpoky-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.xml25
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 329d97838e..585f4ad4da 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1911,18 +1911,18 @@
1911 <title>Installing</title> 1911 <title>Installing</title>
1912 1912
1913 <para> 1913 <para>
1914 During <filename>do_install</filename>, the files and their 1914 During <filename>do_install</filename>, the task copies the
1915 structure that your recipe built are copied to locations on the 1915 built files along with their hierarchy to locations that
1916 target device. 1916 would mirror their locations on the target device.
1917 The installation process moves the 1917 The installation process copies files from the
1918 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename>, 1918 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename>,
1919 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink><filename>}</filename>, 1919 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink><filename>}</filename>,
1920 and 1920 and
1921 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename> 1921 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-WORKDIR'><filename>WORKDIR</filename></ulink><filename>}</filename>
1922 to the 1922 directories to the
1923 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename> 1923 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-D'><filename>D</filename></ulink><filename>}</filename>
1924 to create the structure as it should appear on the target 1924 directory to create the structure as it should appear on the
1925 system. 1925 target system.
1926 </para> 1926 </para>
1927 1927
1928 <para> 1928 <para>
@@ -1939,6 +1939,12 @@
1939 Consequently, you do not have to have a 1939 Consequently, you do not have to have a
1940 <filename>do_install</filename> task as part of your 1940 <filename>do_install</filename> task as part of your
1941 recipe. 1941 recipe.
1942 However, if you wish to install additional files not
1943 already being installed by
1944 <filename>make install</filename>, you should do this
1945 using a <filename>do_install_append</filename> function
1946 using the install command as described in
1947 <emphasis>Manual</emphasis> later in this list.
1942 You just need to make sure the install portion of the 1948 You just need to make sure the install portion of the
1943 build completes with no issues.</para></listitem> 1949 build completes with no issues.</para></listitem>
1944 <listitem><para><emphasis>Other (using 1950 <listitem><para><emphasis>Other (using
@@ -2003,7 +2009,10 @@
2003 2009
2004 <note> 2010 <note>
2005 <filename>oe_runmake install</filename>, which can be run 2011 <filename>oe_runmake install</filename>, which can be run
2006 directly or can be run indirectly by the autotools and CMake 2012 directly or can be run indirectly by the
2013 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink>
2014 and
2015 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink>
2007 classes, runs make install in parallel. 2016 classes, runs make install in parallel.
2008 Sometimes, a Makefile can have missing dependencies between 2017 Sometimes, a Makefile can have missing dependencies between
2009 targets that can result in race conditions. 2018 targets that can result in race conditions.