This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Patch to refine prerequisites docs


This patch improves the documentation of required tools for modifying GCC.
The gettext version requirement is from the features the intl configure
script checks for.  The directories for given autoconf and automake
versions are based on what configure and Makefile.in files were generated
with what version.

Note: I'm hoping that the exact automake 1.7.x version isn't critical in
libstdc++-v3 (some subdirectories use 1.7.6, some 1.7.8; perhaps all
should be regenerated with 1.7.9), and that the exact automake 1.4-px
version isn't critical in the other directories (various versions used).  
I'm aware that there once was a libjava-specific modified automake 1.4,
but I hope that the last 1.4 patch release (1.4-p6) will work for all the
automake 1.4 directories (and perhaps they should all have their generated
files regenerated with that consistent version).

Has the conversion to newer autotools stalled?  There doesn't seem to have
been any traffic at
<http://www.codesourcery.com/archives/autoconf-conversion/maillist.html>
for some time, and we seem to be spending a long time in what should be
the transient situation of needing multiple versions of the same tool.

It passes install.texi2html, make info and make dvi.  Applied to mainline.

Index: ChangeLog
===================================================================
RCS file: /cvs/gcc/gcc/gcc/ChangeLog,v
retrieving revision 2.1761
diff -u -r2.1761 ChangeLog
--- ChangeLog	14 Nov 2003 22:48:11 -0000	2.1761
+++ ChangeLog	15 Nov 2003 20:03:50 -0000
@@ -1,3 +1,9 @@
+2003-11-15  Joseph S. Myers  <jsm@polyomino.org.uk>
+
+	* doc/install.texi (Prerequisites): Refine documentation of
+	autoconf, automake and perl requirements.  Document required
+	gettext version.
+
 2003-11-14  Jason Merrill  <jason@redhat.com>
 
 	* function.c (assign_parms): Use TREE_TYPE to determine the real
Index: doc/install.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/install.texi,v
retrieving revision 1.233
diff -u -r1.233 install.texi
--- doc/install.texi	5 Nov 2003 22:26:58 -0000	1.233
+++ doc/install.texi	15 Nov 2003 20:03:51 -0000
@@ -287,16 +287,23 @@
 @heading Tools/packages necessary for modifying GCC
 @table @asis
 
-@item autoconf version 2.13 (NO earlier or later versions) and
+@item autoconf versions 2.13 and 2.57
 @itemx GNU m4 version 1.4 (or later)
 
 Necessary when modifying @file{configure.in}, @file{aclocal.m4}, etc.@:
-to regenerate @file{configure} and @file{config.in} files
+to regenerate @file{configure} and @file{config.in} files.  Most
+directories require autoconf 2.13 (exactly), but @file{libiberty} and
+@file{libstdc++-v3} require autoconf 2.57 (exactly).
 
-@item automake version ???
+@item automake versions 1.4-p? and 1.7.?
 
 Necessary when modifying a @file{Makefile.am} file to regenerate its
-associated @file{Makefile.in}
+associated @file{Makefile.in}.  Most directories require a 1.4 series
+automake; @file{libstdc++-v3} requires a 1.7 series automake.
+
+@item gettext version 0.12 (or later)
+
+Needed to regenerate @file{gcc.pot}.
 
 @item gperf version 2.7.2 (or later)
 
@@ -362,8 +369,10 @@
 @item perl version 5.6.1 (or later)
 
 Necessary when regenerating @file{Makefile} dependencies in libiberty.
-Necessary when regenerating something with intl??? (pod2man???)
-Other stuff???
+Necessary when regenerating @file{libiberty/functions.texi}.
+Necessary when generating manpages from Texinfo manuals.
+Used by various scripts to generate some files included in CVS (mainly
+Unicode-related and rarely changing) from source tables.
 
 @item GNU diffutils version 2.7 (or later)
 

-- 
Joseph S. Myers
jsm@polyomino.org.uk


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]