summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-01-09 08:43:50 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-01-21 21:57:59 +0000
commitb6c0bae0aa770e8c5a325cb83710c1a5c8fb5017 (patch)
tree5b5067d7e6260df8ed2027415f2cdc4671f79e14
parent814e07159fcc6b30bc66e699a0b153c6eb40e244 (diff)
downloadpoky-b6c0bae0aa770e8c5a325cb83710c1a5c8fb5017.tar.gz
dev-manual: Edits to "Compilation" section.
Added review comments to the section inside the new "Writing a New Recipe" section. Minor word fixes. I did add a new common compilation failure scenario. All input from Paul Eggleton. (From yocto-docs rev: 5818a8882ff55fc27c5dc77233854465b8c2245b) 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.xml26
1 files changed, 22 insertions, 4 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 22209af39a..329d97838e 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1876,15 +1876,33 @@
1876 This failure applies to recipes building for the target 1876 This failure applies to recipes building for the target
1877 or <filename>nativesdk</filename> only. 1877 or <filename>nativesdk</filename> only.
1878 The failure occurs when the compilation process uses 1878 The failure occurs when the compilation process uses
1879 headers, libraries, or other files from the host system 1879 improper headers, libraries, or other files from the
1880 when the process is cross-compiling for the target and 1880 host system during cross-compiling for the target.
1881 should not be.</para> 1881 </para>
1882 <para>To fix the problem, you should be able to see 1882 <para>To fix the problem, you should be able to see
1883 the host paths being used (e.g. 1883 the host paths being used (e.g.
1884 <filename>/usr/include</filename>, 1884 <filename>/usr/include</filename>,
1885 <filename>/usr/lib</filename>, and so forth) by 1885 <filename>/usr/lib</filename>, and so forth) by
1886 examining the <filename>log.do_configure</filename> 1886 examining the <filename>log.do_compile</filename>
1887 file.</para></listitem> 1887 file.</para></listitem>
1888 <listitem><para><emphasis>Failure to find required
1889 libraries/headers:</emphasis>
1890 If a build-time dependency is missing because it has
1891 not been declared in
1892 <ulink url='&YOCTO_DOCS_REF_URL;#var-DEPENDS'><filename>DEPENDS</filename></ulink>,
1893 or because the dependency exists but the path used by
1894 the build process to find the file is incorrect and the
1895 configure step did not detect it, the compilation
1896 process could fail.
1897 For either of these failures, the compilation process
1898 notes that files could not be found.
1899 In these cases, you need to go back and add additional
1900 options to the configure script as well as possibly
1901 add additional build-time dependencies to
1902 <filename>DEPENDS</filename>.
1903 Occasionally, it is necessary to apply a patch to the
1904 source to ensure the correct paths are used.
1905 </para></listitem>
1888 </itemizedlist> 1906 </itemizedlist>
1889 </para> 1907 </para>
1890 </section> 1908 </section>