summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-03-18 20:18:48 (GMT)
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-03-25 12:29:42 (GMT)
commit58a7688afb96a2b3ace1e4ea4bed673c6435dffd (patch)
tree15e41098b61a16317d1e46dc4874b54690b7f480
parentaca4b48cc6a322bed98c12cede07dce730c20fa5 (diff)
downloadpoky-58a7688afb96a2b3ace1e4ea4bed673c6435dffd.tar.gz
dev-manual: Read-thru edits to "Writing a New Recipe"
Minor edits. (From yocto-docs rev: 8e0de3f767af4b2ca182d9f321bd3c8286773913) 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.xml38
1 files changed, 19 insertions, 19 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index e7d1ca4..63c915c 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1324,7 +1324,7 @@
1324 <literallayout class='monospaced'> 1324 <literallayout class='monospaced'>
1325 ${TMPDIR}/work/${MULTIMACH_TARGET_SYS}/${PN}/${EXTENDPE}${PV}-${PR} 1325 ${TMPDIR}/work/${MULTIMACH_TARGET_SYS}/${PN}/${EXTENDPE}${PV}-${PR}
1326 </literallayout> 1326 </literallayout>
1327 As an example, assume a Source Directory top-level folder name 1327 As an example, assume a Source Directory top-level folder named
1328 <filename>poky</filename>, a default Build Directory at 1328 <filename>poky</filename>, a default Build Directory at
1329 <filename>poky/build</filename>, and a 1329 <filename>poky/build</filename>, and a
1330 <filename>qemux86-poky-linux</filename> machine target system. 1330 <filename>qemux86-poky-linux</filename> machine target system.
@@ -1559,9 +1559,9 @@
1559 1559
1560 <para> 1560 <para>
1561 During the build, the <filename>do_unpack</filename> task 1561 During the build, the <filename>do_unpack</filename> task
1562 unpacks the source and 1562 unpacks the source with
1563 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename> 1563 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename>
1564 points to where it will be unpacked. 1564 pointing to where it is unpacked.
1565 </para> 1565 </para>
1566 1566
1567 <para> 1567 <para>
@@ -1833,7 +1833,7 @@
1833 For reference information on configure options specific to the 1833 For reference information on configure options specific to the
1834 software you are building, you can consult the output of the 1834 software you are building, you can consult the output of the
1835 <filename>./configure --help</filename> command within 1835 <filename>./configure --help</filename> command within
1836 <filename>${S}</filename> or consult the upstream 1836 <filename>${S}</filename> or consult the software's upstream
1837 documentation. 1837 documentation.
1838 </para> 1838 </para>
1839 </section> 1839 </section>
@@ -2014,13 +2014,13 @@
2014 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink> 2014 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink>
2015 and 2015 and
2016 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink> 2016 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink>
2017 classes, runs make install in parallel. 2017 classes, runs <filename>make install</filename> in parallel.
2018 Sometimes, a Makefile can have missing dependencies between 2018 Sometimes, a Makefile can have missing dependencies between
2019 targets that can result in race conditions. 2019 targets that can result in race conditions.
2020 If you experience intermittent failures during 2020 If you experience intermittent failures during
2021 <filename>do_install</filename>, you might be able to work 2021 <filename>do_install</filename>, you might be able to work
2022 around them by disabling parallel make install by adding the 2022 around them by disabling parallel Makefile installs
2023 following to the recipe: 2023 by adding the following to the recipe:
2024 <literallayout class='monospaced'> 2024 <literallayout class='monospaced'>
2025 PARALLEL_MAKEINST = "" 2025 PARALLEL_MAKEINST = ""
2026 </literallayout> 2026 </literallayout>
@@ -2052,15 +2052,15 @@
2052 2052
2053 <para> 2053 <para>
2054 When you create the installation for your services, you need 2054 When you create the installation for your services, you need
2055 to accomplish what is normally done by "make install". 2055 to accomplish what is normally done by
2056 In other words, make sure your installation puts the output 2056 <filename>make install</filename>.
2057 in a layout that is similar to how they will be laid out on the 2057 In other words, make sure your installation arranges the output
2058 target system. 2058 similar to how it is arranged on the target system.
2059 </para> 2059 </para>
2060 2060
2061 <para> 2061 <para>
2062 The OpenEmbedded build system provides support for two 2062 The OpenEmbedded build system provides support for starting
2063 different ways of starting services: 2063 services two different ways:
2064 <itemizedlist> 2064 <itemizedlist>
2065 <listitem><para><emphasis>SysVinit:</emphasis> 2065 <listitem><para><emphasis>SysVinit:</emphasis>
2066 SysVinit is a system and service manager that 2066 SysVinit is a system and service manager that
@@ -2083,19 +2083,19 @@
2083 <ulink url='&YOCTO_DOCS_REF_URL;#var-INITSCRIPT_PARAMS'><filename>INITSCRIPT_PARAMS</filename></ulink> 2083 <ulink url='&YOCTO_DOCS_REF_URL;#var-INITSCRIPT_PARAMS'><filename>INITSCRIPT_PARAMS</filename></ulink>
2084 variables within your recipe.</para></listitem> 2084 variables within your recipe.</para></listitem>
2085 <listitem><para><emphasis>Systemd:</emphasis> 2085 <listitem><para><emphasis>Systemd:</emphasis>
2086 Systemd was designed to replace SysVinit and provide 2086 Systemd was designed to replace SysVinit and to provide
2087 enhanced management of services. 2087 enhanced management of services.
2088 For more information on Systemd, see the Systemd 2088 For more information on Systemd, see the Systemd
2089 homepage at 2089 homepage at
2090 <ulink url='http://freedesktop.org/wiki/Software/systemd/'></ulink>. 2090 <ulink url='http://freedesktop.org/wiki/Software/systemd/'></ulink>.
2091 </para> 2091 </para>
2092 <para>To enable a service using Systemd, your recipe 2092 <para>To enable a service using Systemd, your recipe
2093 needs to inherit the <filename>systemd</filename> class. 2093 needs to inherit the
2094 <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-systemd'><filename>systemd.bbclass</filename></ulink>
2095 class.
2094 See the <filename>systemd.bbclass</filename> file 2096 See the <filename>systemd.bbclass</filename> file
2095 located in your 2097 located in your
2096 <link linkend='source-directory'>Source Directory</link> 2098 <link linkend='source-directory'>Source Directory</link>.
2097 in <filename>meta/classes</filename> or the
2098 "<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-systemd'><filename>systemd.bbclass</filename></ulink>"
2099 section for more information.</para></listitem> 2099 section for more information.</para></listitem>
2100 </itemizedlist> 2100 </itemizedlist>
2101 </para> 2101 </para>
@@ -2154,7 +2154,7 @@
2154 package is included in an image. 2154 package is included in an image.
2155 To add a post-installation script to a package, add a 2155 To add a post-installation script to a package, add a
2156 <filename>pkg_postinst_PACKAGENAME()</filename> function to 2156 <filename>pkg_postinst_PACKAGENAME()</filename> function to
2157 the <filename>.bb</filename> file and use 2157 the recipe file (<filename>.bb</filename>) and use
2158 <filename>PACKAGENAME</filename> as the name of the package 2158 <filename>PACKAGENAME</filename> as the name of the package
2159 you want to attach to the <filename>postinst</filename> 2159 you want to attach to the <filename>postinst</filename>
2160 script. 2160 script.