This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Doc for autoconf and automake versions
- From: "Joseph S. Myers" <jsm at polyomino dot org dot uk>
- To: gcc-patches at gcc dot gnu dot org
- Cc: libstdc++ at gcc dot gnu dot org, java at gcc dot gnu dot org, fche at redhat dot com, bonzini at gnu dot org
- Date: Fri, 11 Jun 2004 16:52:09 +0000 (UTC)
- Subject: Doc for autoconf and automake versions
This patch updates the documentation of the versions of autoconf and
automake used in the tree. It strictly follows those indicated in the
comments on the relevant files (exact versions should always be used
to avoid churn on the generated files when they get regenerated by
different people). It passes install.texi2html, "make info" and "make
dvi". Applied to mainline.
Though there has been much progress on updating to more recent
versions (please remember to update the documentation when doing so!),
there are now three versions of autoconf and six of automake used in
the tree, which is unreasonable (and an oversimplification, as some of
the automake 1.4-gcj versions have different comment strings
suggesting it isn't really that version). I hope that it is a mistake
rather than a deliberate choice of special versions that libmudflap
uses autoconf 2.57 and automake 1.7.8 rather than 2.59 and 1.7.9, and
that its files can be regenerated with the new versions and the
documentation updated. I also hope that libcpp and libstdc++-v3 can
have their files regenerated with automake 1.8.5, as used for
libgfortran, so that only one 1.8.x version is needed.
Where was the introduction of use of a third automake release series
(1.8.x) without getting rid of at least one of the previous versions
at the same time discussed? Even during transitions, I think we
should have no more than two versions of either autoconf or automake
in use in the tree at once, and when a new bug-fix automake comes out
(successive 1.8.x versions) the whole tree and documentation should be
updated at once rather than having the versions diverge.
2004-06-11 Joseph S. Myers <jsm@polyomino.org.uk>
* doc/install.texi (Prerequisites): Update documentation of
required versions of autoconf and automake. Remove mention of
libf2c.
--- install.texi.orig 2004-06-10 21:50:50.000000000 +0000
+++ install.texi 2004-06-11 16:32:41.000000000 +0000
@@ -296,31 +296,41 @@
@heading Tools/packages necessary for modifying GCC
@table @asis
-@item autoconf versions 2.13 and 2.59
+@item autoconf versions 2.13, 2.57 and 2.59
@itemx GNU m4 version 1.4 (or later)
Necessary when modifying @file{configure.ac}, @file{aclocal.m4}, etc.@:
to regenerate @file{configure} and @file{config.in} files. Most
-directories require autoconf 2.59 (exactly), but the toplevel, @file{libf2c},
-@file{libobjc}, @file{zlib}, and @file{libjava} (except for
-@file{libjava/libltdl}) still require autoconf 2.13 (exactly).
+directories require autoconf 2.59 (exactly), but the toplevel and
+@file{libjava} (but not @file{libjava/libltdl}) still require autoconf
+2.13 (exactly) and @file{libmudflap} requires autoconf 2.57 (exactly).
-@item automake versions 1.4-gcj and 1.7.9
+@item automake versions 1.4-gcj, 1.7.8, 1.7.9, 1.8.2, 1.8.4 and 1.8.5
Necessary when modifying a @file{Makefile.am} file to regenerate its
associated @file{Makefile.in}.
Much of GCC does not use automake, so directly edit the @file{Makefile.in}
file. Specifically this applies to the @file{gcc}, @file{intl},
-@file{libf2c}, @file{libiberty}, @file{libobjc} directories as well as any
+@file{libiberty}, @file{libobjc} directories as well as any
of their subdirectories.
-The @file{libstdc++-v3}, @file{libjava/libltdl}, @file{fastjar} and
-@file{libffi} directories require automake 1.7.9. However, the Java
-directories, which include @file{boehm-gc}, @file{libjava}, and @file{zlib},
+The Java directories @file{boehm-gc} and @file{libjava}
require a modified version of automake 1.4 downloadable from
@uref{ftp://gcc.gnu.org/pub/java/automake-gcj-1.4.tar.gz}.
+The @file{libmudflap} directory requires automake 1.7.8.
+
+The @file{fastjar}, @file{libbanshee}, @file{libffi},
+@file{libjava/libltdl} and @file{zlib} directories require automake
+1.7.9.
+
+The @file{libstdc++-v3} directory requires automake 1.8.2.
+
+The @file{libcpp} directory requires automake 1.8.4.
+
+The @file{libgfortran} directory requires automake 1.8.5.
+
@item gettext version 0.12 (or later)
Needed to regenerate @file{gcc.pot}.
--
Joseph S. Myers
jsm@polyomino.org.uk