From c53eacfc26ad223d987327c387624d2108d1a2db Mon Sep 17 00:00:00 2001 From: panne Date: Thu, 5 Feb 2004 14:35:44 +0000 Subject: [PATCH] [project @ 2004-02-05 14:35:44 by panne] * (Hopefully) made the recursive nature of autoreconf clear * We don't need automake * configure doesn't create a cache by default --- docs/building/building.sgml | 79 ++++++++++++++++--------------------------- 1 file changed, 30 insertions(+), 49 deletions(-) diff --git a/docs/building/building.sgml b/docs/building/building.sgml index 7196bf1..3163611 100644 --- a/docs/building/building.sgml +++ b/docs/building/building.sgml @@ -1298,23 +1298,24 @@ $ cvs checkout nofib/spectral - Autoreconf - pre-supposed: Autoreconf - Autoreconf, pre-supposed + autoconf + pre-supposed: autoconf + autoconf, pre-supposed - GNU Autoreconf is needed if you intend to build from the + GNU autoconf is needed if you intend to build from the CVS sources, it is not needed if you just intend to build a standard source distribution. - Version 2.52 or later of autoreconf is required. - NB. vesrion 2.13 will no longer work, as of GHC version + Version 2.52 or later of the autoconf package is required. + NB. version 2.13 will no longer work, as of GHC version 6.1. - Autoreconf builds the configure - script from configure.ac and - aclocal.m4. If you modify either of - these files, you'll need autoreconf to - rebuild configure. + autoreconf (from the autoconf package) + recursively builds configure scripts from + the corresponding configure.ac and + aclocal.m4 files. If you modify one of + the latter files, you'll need autoreconf to + rebuild the corresponding configure. @@ -1606,13 +1607,14 @@ $ make install Change directory to $(FPTOOLS_TOP) and - issue the command + issue the command autoreconf autoreconf - (with no arguments). This GNU program converts - $(FPTOOLS_TOP)/configure.ac + (with no arguments). This GNU program (recursively) converts + $(FPTOOLS_TOP)/configure.ac and + $(FPTOOLS_TOP)/aclocal.m4 to a shell script called $(FPTOOLS_TOP)/configure. If autoreconf bleats that it can't write the file configure, @@ -1621,18 +1623,16 @@ autoreconf a message like "No rule to make target 'mk/config.h.in'". - Some projects, including GHC, have their own - configure script. If there's an - $(FPTOOLS_TOP)/<project>/configure.ac, - then you need to run autoreconf in that - directory too. - - These steps are completely - platform-independent; they just mean that the - human-written file (configure.ac) can - be short, although the resulting shell script, - configure, and - mk/config.h.in, are long. + Some projects, including GHC, have their own configure script. + autoreconf takes care of that, too, so all you have + to do is calling autoreconf in the top-level directory + $(FPTOOLS_TOP). + + These steps are completely platform-independent; they just mean + that the human-written files (configure.ac and + aclocal.m4) can be short, although the resulting + files (the configure shell scripts and the C header + template mk/config.h.in) are long. @@ -1736,13 +1736,6 @@ autoreconf - - configure caches the results of - its run in config.cache. Quite often - you don't want that; you're running - configure a second time because - something has changed. In that case, simply delete - config.cache. @@ -1914,14 +1907,6 @@ $ autoreconf source distribution, and you already have configure and mk/config.h.in.) - - Some projects, including GHC itself, have their own - configure scripts, so it is necessary to run autoreconf again - in the appropriate subdirectories. eg: - - -$ (cd ghc; autoreconf) - @@ -4462,10 +4447,7 @@ During the installation dialogue, make sure that you select all of the following openssh, - autoreconf, - - - automake, + autoconf, binutils (includes ld and (I think) ar), @@ -4725,9 +4707,8 @@ you about Windows-specific wrinkles. -Run autoreconf both in fptools -and in fptools/ghc. If you omit the latter step you'll -get an error when you run ./configure: +If you used autoconf instead of autoreconf, +you'll get an error when you run ./configure: ...lots of stuff... creating mk/config.h @@ -4744,7 +4725,7 @@ configure: error: ./configure failed for ghc read-only. So if you need to run autoreconf again (which I sometimes do for safety's sake), you get -/usr/bin/autoreconf: cannot create configure: permission denied +/usr/bin/autoconf: cannot create configure: permission denied Solution: delete configure first. -- 1.7.10.4