diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-01-09 08:43:50 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-21 21:57:59 +0000 |
commit | b6c0bae0aa770e8c5a325cb83710c1a5c8fb5017 (patch) | |
tree | 5b5067d7e6260df8ed2027415f2cdc4671f79e14 /documentation | |
parent | 814e07159fcc6b30bc66e699a0b153c6eb40e244 (diff) | |
download | ast2050-yocto-poky-b6c0bae0aa770e8c5a325cb83710c1a5c8fb5017.zip ast2050-yocto-poky-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>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 26 |
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 22209af..329d978 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -1876,15 +1876,33 @@ This failure applies to recipes building for the target or <filename>nativesdk</filename> only. The failure occurs when the compilation process uses - headers, libraries, or other files from the host system - when the process is cross-compiling for the target and - should not be.</para> + improper headers, libraries, or other files from the + host system during cross-compiling for the target. + </para> <para>To fix the problem, you should be able to see the host paths being used (e.g. <filename>/usr/include</filename>, <filename>/usr/lib</filename>, and so forth) by - examining the <filename>log.do_configure</filename> + examining the <filename>log.do_compile</filename> file.</para></listitem> + <listitem><para><emphasis>Failure to find required + libraries/headers:</emphasis> + If a build-time dependency is missing because it has + not been declared in + <ulink url='&YOCTO_DOCS_REF_URL;#var-DEPENDS'><filename>DEPENDS</filename></ulink>, + or because the dependency exists but the path used by + the build process to find the file is incorrect and the + configure step did not detect it, the compilation + process could fail. + For either of these failures, the compilation process + notes that files could not be found. + In these cases, you need to go back and add additional + options to the configure script as well as possibly + add additional build-time dependencies to + <filename>DEPENDS</filename>. + Occasionally, it is necessary to apply a patch to the + source to ensure the correct paths are used. + </para></listitem> </itemizedlist> </para> </section> |