install.texi (Prerequisites): Explicitly mention C library and its headers for multil...

	* doc/install.texi (Prerequisites): Explicitly mention C library
	and its headers for multilib builds.

From-SVN: r205802

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 18537e8ead036ea3dffaae98a05e1d755feb2ba6..da673194ab1d0c35da4fa97a90554848cff2a4d0 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2013-12-09  Francois-Xavier Coudert  <fxcoudert@gcc.gnu.org>
+
+       * doc/install.texi (Prerequisites): Explicitly mention C library
+       and its headers for multilib builds.
+
 2013-12-08  Oleg Endo  <olegendo@gcc.gnu.org>
 
        PR target/52898

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index a8f9f8a79801bae36326fe7eaf3b5daf55a62ff8..85899b019c564d8c5dca2ffa083a5e0b25dd0568 100644 (file)
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -255,6 +255,22 @@ may need to use @option{--disable-stage1-checking}, though
 bootstrapping the compiler with such earlier compilers is strongly
 discouraged.
 
+@item C standard library and headers
+
+In order to build GCC, the C standard library and headers must be present
+for all target variants for which target libraries will be built (and not
+only the variant of the host C++ compiler).
+
+This affects the popular @samp{x86_64-unknown-linux-gnu} platform (among
+other multilib targets), for which 64-bit (@samp{x86_64}) and 32-bit
+(@samp{i386}) libc headers are usually packaged separately. If you do a
+build of a native compiler on @samp{x86_64-unknown-linux-gnu}, make sure you
+either have the 32-bit libc developer package properly installed (the exact
+name of the package depends on your distro) or you must build GCC as a
+64-bit only compiler by configuring with the option
+@option{--disable-multilib}.  Otherwise, you may encounter an error such as
+@samp{fatal error: gnu/stubs-32.h: No such file}
+
 @item GNAT
 
 In order to build the Ada compiler (GNAT) you must already have GNAT