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.
+