> As a consensual first step toward addressing this issue, I suggest the
> following patch to the doc. I hope it is clear enough, but suggestions are
> obviously welcome. (I haven't even compiled the docs with it, as I'm on my
> laptop with little battery.)
Given that I received no feedback, I'd like to submit this doc patch formally.
Tested by doing "make info html pdf".
OK to commit to trunk? What about other active release branches?
FX
Index: install.texi
===================================================================
--- install.texi (revision 201292)
+++ install.texi (working copy)
@@ -255,6 +255,26 @@ may need to use @option{--disable-stage1
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}, beware of
+either:
+
+@itemize @bullet
+@item having 32-bit libc developer package properly installed (the exact
+name of the package depends on your distro); otherwise, you may encounter an
+error such as @samp{fatal error: gnu/stubs-32.h: No such file}
+@item building GCC as a 64-bit only compiler, by configuring with the
+option @option{--disable-multilib}
+@end itemize
+
@item GNAT
In order to build the Ada compiler (GNAT) you must already have GNAT
