3.1 PATCH: install.texi updates for GCC 3.1

Fri May 3 08:24:00 GMT 2002

Gerald Pfeifer writes:

> Yes, thanks!  (It would be great could you also add a note to
> htdocs/branching.html on the need to update the buildstats.html
> link in gcc/doc/install.texi.)

Ok: here's what I'd like to check in:

Index: branching.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/branching.html,v
retrieving revision 1.3
diff -u -p -r1.3 branching.html

--- branching.html	14 Mar 2002 12:07:11 -0000	1.3
+++ branching.html	3 May 2002 15:23:11 -0000
@@ -30,6 +30,14 @@ the next major release number (e.g., 3.2
 use the next major release number.  Also, update the version number in 
 <code>java/gcj.texi</code> and <code>f/root.texi</code>.</li>
 
+<li>Create a new <code>gcc-<var>VERSION</var></code> directory in the
+<code>wwwstats</code> repository and populate it with initial
+copies of <code>buildstat.html</code>, <code>caveats.html</code>,
+<code>changes.html</code>, and <code>criteria.html</code></li>
+
+<li>Update <code>doc/install.texi</code> to reference the newly created
+<code>buildstat.html</code>.</li>
+
 <li>Update <code>f/root.texi</code> on the branch to use <code>@clear
 DEVELOPMENT</code>.</li>
 
> If you agree, let's remove the one in the "Host/target specific
> installation notes for GCC".

Indeed: that instance carries the least value for the reader.

> Perhaps we should make this "GCC 3.0 and up" as well? (I don't think
> GCC 2.95.x will be able to compile GCC 4.0 on HP-UX 11. ;-) )

Done.

Here's what I have checked in.

	Rainer


Fri May  3 01:18:01 2002  Rainer Orth  <ro@TechFak.Uni-Bielefeld.DE>

	* doc/install.texi (Installing): Mention GCC 3.1 buildstats.
	(Specific): Removed buildstats references.
	(Specific, hppa*-hp-hpux11): Adjust for GCC versions > 3.0.
	(Specific, sparc-sun-solaris2*): Update 64-bit hints for GCC 3.1.
	Accomodate Solaris versions beyond 8.
	(Specific, sparc-sun-solaris2.7): Update as path for GCC 3.1.
	(Specific, *-*-solaris2.8): Removed, obsolete.

Index: doc/install.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/install.texi,v
retrieving revision 1.92.2.21
diff -u -p -r1.92.2.21 install.texi
--- doc/install.texi	2 May 2002 23:29:52 -0000	1.92.2.21
+++ doc/install.texi	3 May 2002 15:00:08 -0000
@@ -152,6 +152,7 @@ you proceed.
 
 Lists of successful builds for released versions of GCC are
 available at our web pages for
+@uref{http://gcc.gnu.org/gcc-3.1/buildstat.html,,3.1}, 
 @uref{http://gcc.gnu.org/gcc-3.0/buildstat.html,,3.0}
 and
 @uref{http://gcc.gnu.org/gcc-2.95/buildstat.html,,2.95}.
@@ -1487,13 +1488,6 @@ works.
 Please read this document carefully @emph{before} installing the
 GNU Compiler Collection on your machine.
 
-Lists of successful builds for released versions of GCC are
-available at our web pages for
-@uref{http://gcc.gnu.org/gcc-3.0/buildstat.html,,3.0}
-and
-@uref{http://gcc.gnu.org/gcc-2.95/buildstat.html,,2.95}.
-These lists are updated as new information becomes available.
-
 @ifhtml
 @itemize
 @item
@@ -1671,8 +1665,6 @@ These lists are updated as new informati
 @item
 @uref{#sparc-sun-solaris2.7,,sparc-sun-solaris2.7}
 @item
-@uref{#*-*-solaris2.8,,*-*-solaris2.8}
-@item
 @uref{#sparc-sun-sunos4*,,sparc-sun-sunos4*}
 @item
 @uref{#sparc-unknown-linux-gnulibc1,,sparc-unknown-linux-gnulibc1}
@@ -2220,14 +2212,14 @@ bootstrap}.
 @end html
 @heading @anchor{hppa*-hp-hpux11}hppa*-hp-hpux11
 
-GCC 3.0 supports HP-UX 11.  You must use GNU binutils 2.11 or above on
+GCC 3.0 and up support HP-UX 11.  You must use GNU binutils 2.11 or above on
 this platform.  Thread support is not currently implemented for this
 platform, so @option{--enable-threads} does not work.
 See @uref{http://gcc.gnu.org/ml/gcc-prs/2002-01/msg00551.html}
 and @uref{http://gcc.gnu.org/ml/gcc-bugs/2002-01/msg00663.html}.
 GCC 2.95.x is not supported under HP-UX 11 and cannot be used to
-compile GCC 3.0.  Refer to @uref{binaries.html,,binaries} for information
-about obtaining precompiled GCC binaries for HP-UX.
+compile GCC 3.0 and up.  Refer to @uref{binaries.html,,binaries} for
+information about obtaining precompiled GCC binaries for HP-UX.
 
 @html
 </p>
@@ -3531,15 +3523,14 @@ This is Sun bug 4237974.  This is fixed 
 starting with Solaris 7.
 
 Starting with Solaris 7, the operating system is capable of executing
-64-bit SPARC V9 binaries.  GCC 3.1 and later should properly support
-this.  GCC 3.0 lacks the infrastructure necessary to support this
-configuration properly.  However, if all you want is code tuned for
-the UltraSPARC CPU, you should try the @option{-mtune=ultrasparc}
-option instead, which should be safe from those bugs and produce code
-that, unlike full 64-bit code, can still run on non-UltraSPARC
+64-bit SPARC V9 binaries.  GCC 3.1 and later properly supports
+this; the @option{-m64} option enables 64-bit code generation.
+However, if all you want is code tuned for the UltraSPARC CPU, you
+should try the @option{-mtune=ultrasparc} option instead, which produces
+code that, unlike full 64-bit code, can still run on non-UltraSPARC
 machines.
 
-When configuring on a Solaris 7 or 8 system that is running a kernel
+When configuring on a Solaris 7 or later system that is running a kernel
 that supports only 32-bit binaries, one must configure with
 @option{--disable-multilib}, since we will not be able to build the
 64-bit target libraries.
@@ -3568,7 +3559,7 @@ back it out.
 @item
 Copy the original, unpatched Solaris 7
 @command{/usr/ccs/bin/as} into
-@command{/usr/local/lib/gcc-lib/sparc-sun-solaris2.7/3.0/as},
+@command{/usr/local/lib/gcc-lib/sparc-sun-solaris2.7/3.1/as},
 adjusting the latter name to fit your local conventions and software
 version numbers.
 
@@ -3585,21 +3576,6 @@ the bug.  The current (as of 2001-09-24)
 the Solaris 7 Recommended Patch Cluster.
 @end itemize
 
-
-@html
-<p>
-<hr>
-@end html
-@heading @anchor{*-*-solaris2.8}*-*-solaris2.8
-
-The Solaris 8 linker fails to link some @samp{libjava} programs if
-previously-installed GCC java libraries already exist in the configured
-prefix.  For this reason, @command{configure} will report an error on
-Solaris 8 if an existing @samp{libgcj} is found in the appropriate
-install directory and the system linker is in use.  In this case, you
-can configure with a different prefix, or delete or rename the existing
-@samp{libgcj} library files before configuring, or configure using
-@option{--disable-libgcj}.
 
 @html
 <p>

