This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[doc] Improve support library requirements documentation (PR bootstrap/48135)
- From: Rainer Orth <ro at CeBiTec dot Uni-Bielefeld dot DE>
- To: gcc-patches at gcc dot gnu dot org
- Cc: Richard Guenther <rguenther at suse dot de>, "Joseph S. Myers" <joseph at codesourcery dot com>
- Date: Mon, 21 Mar 2011 12:17:15 +0100
- Subject: [doc] Improve support library requirements documentation (PR bootstrap/48135)
While investigating PR bootstrap/48135, it came up that the submitter
had run into trouble bootstrapping with mpc 0.9.0. Unfortunately,
install.texi when describing support library requirements always lists
`(or later)' with the individual libraries.
Users who don't have the minimal required library installed (or even
those that do) often tend to build the latest release available instead
of the minimum, which has often led to trouble in the past, e.g. with
GMP 5.0.
I've therefore added a paragraph in front of the support libraries
explaining the situation and suggesting to stick with the exact versions
mentioned. I've left the `(or later)' for the time being; we should
further improve install.texi by listing ranges of known-good versions
there.
Ok for mainline and the 4.6 branch?
Rainer
2011-03-19 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
PR bootstrap/48135
* doc/install.texi (Prerequisites): Move jar etc. up.
Explain support library version requirements.
diff -r c1a515add087 gcc/doc/install.texi
--- a/gcc/doc/install.texi Sat Mar 19 10:25:56 2011 +0100
+++ b/gcc/doc/install.texi Sat Mar 19 10:35:17 2011 +0100
@@ -319,6 +319,20 @@
Used by various scripts to generate some files included in SVN (mainly
Unicode-related and rarely changing) from source tables.
+@item @command{jar}, or InfoZIP (@command{zip} and @command{unzip})
+
+Necessary to build libgcj, the GCJ runtime.
+
+@end table
+
+Several support libraries are necessary to build GCC, some are required,
+others optional. While any sufficiently new version of required tools
+usually work, library requirements are generally stricter. Newer
+versions may work in some cases, but it's safer to use the exact
+versions documented. We appreciate bug reports about problems with
+newer versions, though.
+
+@table @asis
@item GNU Multiple Precision Library (GMP) version 4.3.2 (or later)
Necessary to build GCC@. If you do not have it installed in your
@@ -374,10 +388,6 @@
In both cases @option{--with-cloog} configure option should be used
if CLooG is not installed in your default library search path.
-@item @command{jar}, or InfoZIP (@command{zip} and @command{unzip})
-
-Necessary to build libgcj, the GCJ runtime.
-
@end table
@heading Tools/packages necessary for modifying GCC
--
-----------------------------------------------------------------------------
Rainer Orth, Center for Biotechnology, Bielefeld University