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 @@ This failure applies to recipes building for the target or nativesdk 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. + improper headers, libraries, or other files from the + host system during cross-compiling for the target. + To fix the problem, you should be able to see the host paths being used (e.g. /usr/include, /usr/lib, and so forth) by - examining the log.do_configure + examining the log.do_compile file. + Failure to find required + libraries/headers: + If a build-time dependency is missing because it has + not been declared in + DEPENDS, + 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 + DEPENDS. + Occasionally, it is necessary to apply a patch to the + source to ensure the correct paths are used. +