From patchwork Mon Mar 21 11:17:15 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rainer Orth X-Patchwork-Id: 87742 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) by ozlabs.org (Postfix) with SMTP id 3C1AAB6F10 for ; Mon, 21 Mar 2011 22:17:30 +1100 (EST) Received: (qmail 1172 invoked by alias); 21 Mar 2011 11:17:28 -0000 Received: (qmail 1158 invoked by uid 22791); 21 Mar 2011 11:17:27 -0000 X-SWARE-Spam-Status: No, hits=-1.8 required=5.0 tests=AWL, BAYES_00, T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from snape.CeBiTec.Uni-Bielefeld.DE (HELO smtp-relay.CeBiTec.Uni-Bielefeld.DE) (129.70.160.84) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 21 Mar 2011 11:17:21 +0000 Received: from localhost (localhost.CeBiTec.Uni-Bielefeld.DE [127.0.0.1]) by smtp-relay.CeBiTec.Uni-Bielefeld.DE (Postfix) with ESMTP id 240029D3; Mon, 21 Mar 2011 12:17:19 +0100 (CET) Received: from smtp-relay.CeBiTec.Uni-Bielefeld.DE ([127.0.0.1]) by localhost (malfoy.CeBiTec.Uni-Bielefeld.DE [127.0.0.1]) (amavisd-new, port 10024) with LMTP id NKrRoUAaL59S; Mon, 21 Mar 2011 12:17:17 +0100 (CET) Received: from manam.CeBiTec.Uni-Bielefeld.DE (manam.CeBiTec.Uni-Bielefeld.DE [129.70.161.120]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp-relay.CeBiTec.Uni-Bielefeld.DE (Postfix) with ESMTPS id DA03D9D2; Mon, 21 Mar 2011 12:17:16 +0100 (CET) Received: (from ro@localhost) by manam.CeBiTec.Uni-Bielefeld.DE (8.14.4+Sun/8.14.4/Submit) id p2LBHFFs015466; Mon, 21 Mar 2011 12:17:15 +0100 (MET) From: Rainer Orth To: gcc-patches@gcc.gnu.org Cc: Richard Guenther , "Joseph S. Myers" Subject: [doc] Improve support library requirements documentation (PR bootstrap/48135) Date: Mon, 21 Mar 2011 12:17:15 +0100 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (usg-unix-v) MIME-Version: 1.0 X-IsSubscribed: yes Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org 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 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