ref-manual: Created "Development Host System Issues" section

Fixes YOCTO #2790

Created a new section in the "Debugging Build Failures"
section to deal with host issues that cause a build to
fail.

(From yocto-docs rev: 9efc00146764086646b0c558d12168ab9813d683)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-02-08 11:05:48 -06:00 committed by Richard Purdie
parent dc7221b2fc
commit 717c56caff
1 changed files with 31 additions and 0 deletions

View File

@ -222,6 +222,37 @@
</para>
</section>
<section id='development-host-system-issues'>
<title>Development Host System Issues</title>
<para>
Sometimes issues on the host development system can cause your
build to fail.
Following are known, host-specific problems.
Be sure to always consult the
<ulink url='&YOCTO_HOME_URL;/download/yocto/yocto-project-&DISTRO;-release-notes-poky-&POKYVERSION;'>Release Notes</ulink>
for a look at all release-related issues.
<itemizedlist>
<listitem><para><emphasis><filename>eglibc-initial</filename> fails to build</emphasis>:
If your development host system has the unpatched
<filename>GNU Make 3.82</filename>,
the <filename>do_install</filename> task
fails for <filename>eglibc-initial</filename> during the
build.</para>
<para>Typically, every distrobution that ships
<filename>GNU Make 3.82</filename> as
the default already has the patched version.
However, some distributions, such as Debian, have
<filename>GNU Make 3.82</filename> as an option, which
is unpatched.
You will see this error on these types of distributions.
Switch to <filename>GNU Make 3.81</filename> or patch
your <filename>make</filename> to solve the problem.
</para></listitem>
</itemizedlist>
</para>
</section>
<section id='usingpoky-debugging-buildfile'>
<title>Building with No Dependencies</title>
<para>