diff mbox

[doc] Update install.texi for Solaris 2, IRIX, Tru64 UNIX

Message ID ydd4o71q28c.fsf@manam.CeBiTec.Uni-Bielefeld.DE
State New
Headers show

Commit Message

Rainer Orth March 17, 2011, 1:57 p.m. UTC 
I've just reviewed install.texi for my platforms and found it mostly
accurate.  A few minor changes are desirable for the 4.6 release, but
also apply to mainline since the file is identical there:

* Update recommendations to binutils 2.21 since this is what I've been
  testing.

* Remove download URL for Sun Studio compilers since AFAIK we're not
  supposed to link to non-free software.

Tested with make doc/gccinstall.info doc/gccinstall.pdf
`pwd`/HTML/gcc-4.7.0/gccinstall/index.html (the latter seems a bit
contorted to regen just a single html document) and visually inspection.

Ok for mainline and 4.6 branch?

	Rainer


2011-03-16  Rainer Orth  <ro@CeBiTec.Uni-Bielefeld.DE>

	gcc:
	* doc/install.texi (Specific, alpha*-dec-osf5.1): Update for
	binutils 2.21.
	(Specific, i?86-*-solaris2.[89]): Likewise.
	(Specific, i?86-*-solaris2.10): Likewise.
	(Specific, mips-sgi-irix6): Likewise.
	(Specific, *-*-solaris2*): Remove Sun Studio download URL.
	Update for binutils 2.21.

Comments

Gerald Pfeifer March 21, 2011, 11:23 a.m. UTC | #1 
On Thu, 17 Mar 2011, Rainer Orth wrote:
> I've just reviewed install.texi for my platforms and found it mostly
> accurate.  A few minor changes are desirable for the 4.6 release, but
> also apply to mainline since the file is identical there:
> 
> * Update recommendations to binutils 2.21 since this is what I've been
>   testing.

Since you're the primary tester and often only on these platforms, I
guess this is fine, otherwise (on GNU/Linux x86, say) it might be a bit
too strict.

> * Remove download URL for Sun Studio compilers since AFAIK we're not
>   supposed to link to non-free software.

Oh, sorry, I failed to follow up on your earlier response on that thread.

> Ok for mainline and 4.6 branch?

Yes, thank you.

Gerald
Rainer Orth March 21, 2011, 12:07 p.m. UTC | #2 
Gerald Pfeifer <gerald@pfeifer.com> writes:

> On Thu, 17 Mar 2011, Rainer Orth wrote:
>> I've just reviewed install.texi for my platforms and found it mostly
>> accurate.  A few minor changes are desirable for the 4.6 release, but
>> also apply to mainline since the file is identical there:
>> 
>> * Update recommendations to binutils 2.21 since this is what I've been
>>   testing.
>
> Since you're the primary tester and often only on these platforms, I
> guess this is fine, otherwise (on GNU/Linux x86, say) it might be a bit
> too strict.

I've carefully worded to be only a recommendation, stating at the same
time when the bundled versions should work too.  2.21 is an important
improvement over 2.20 since I've fixed several bugs there, especially
related to TLS support.

>> * Remove download URL for Sun Studio compilers since AFAIK we're not
>>   supposed to link to non-free software.
>
> Oh, sorry, I failed to follow up on your earlier response on that thread.

No problem, just stumbled over it again when re-reading the sections on
my targets.

	Rainer
diff mbox

Patch

diff -r 86718f6d9f54 gcc/doc/install.texi
--- a/gcc/doc/install.texi	Wed Mar 16 08:40:07 2011 +0000
+++ b/gcc/doc/install.texi	Wed Mar 16 19:03:28 2011 +0100
@@ -3102,7 +3102,7 @@ 
 the OS version used, you need a data segment size between 512 MB and
 1 GB, so simply use @command{ulimit -Sd unlimited}.
 
-As of GNU binutils 2.20.1, neither GNU @command{as} nor GNU @command{ld}
+As of GNU binutils 2.21, neither GNU @command{as} nor GNU @command{ld}
 are supported on Tru64 UNIX, so you must not configure GCC with
 @option{--with-gnu-as} or @option{--with-gnu-ld}.
 
@@ -3534,7 +3534,7 @@ 
 While GCC works around them, several features are missing, so it is
 @c FIXME: which ones?
 recommended to use the GNU assembler instead.  There is no bundled
-version, but the current version, from GNU binutils 2.20.1, is known to
+version, but the current version, from GNU binutils 2.21, is known to
 work.
 
 Solaris@tie{}2/x86 doesn't support the execution of SSE/SSE2 instructions
@@ -3560,7 +3560,7 @@ 
 @file{/usr/sfw/bin/gas}.  The versions included in Solaris 10, from GNU
 binutils 2.15, and Solaris 11, from GNU binutils 2.19, work fine,
 although the current version, from GNU binutils
-2.20.1, is known to work, too.  Recent versions of the Sun assembler in
+2.21, is known to work, too.  Recent versions of the Sun assembler in
 @file{/usr/ccs/bin/as} work almost as well, though.
 @c FIXME: as patch requirements?
 
@@ -3568,7 +3568,7 @@ 
 linker instead, which is available in @file{/usr/sfw/bin/gld}, note that
 due to a packaging bug the version in Solaris 10, from GNU binutils
 2.15, cannot be used, while the version in Solaris 11, from GNU binutils
-2.19, works, as does the latest version, from GNU binutils 2.20.1.
+2.19, works, as does the latest version, from GNU binutils 2.21.
 
 To use GNU @command{as}, configure with the options
 @option{--with-gnu-as --with-as=@//usr/@/sfw/@/bin/@/gas}.  It may be necessary
@@ -3997,7 +3997,7 @@ 
 have the 64-bit libraries installed.
 
 GCC must be configured with GNU @command{as}.  The latest version, from GNU
-binutils 2.20.1, is known to work.  On the other hand, bootstrap fails
+binutils 2.21, is known to work.  On the other hand, bootstrap fails
 with GNU @command{ld} at least since GNU binutils 2.17.
 
 The @option{--enable-libgcj}
@@ -4140,8 +4140,7 @@ 
 Support for Solaris 7 has been removed in GCC 4.6.
 
 Sun does not ship a C compiler with Solaris 2, though you can download
-the Sun Studio compilers for free from
-@uref{http://developers.sun.com/sunstudio/downloads/}.  Alternatively,
+the Sun Studio compilers for free.  Alternatively,
 you can install a pre-built GCC to bootstrap and install GCC.  See the
 @uref{binaries.html,,binaries page} for details.
 
@@ -4184,7 +4183,7 @@ 
 conjunction with the Sun linker.  The GNU @command{as}
 versions included in Solaris 10, from GNU binutils 2.15, and Solaris 11,
 from GNU binutils 2.19, are known to work.  They can be found in
-@file{/usr/sfw/bin/gas}.  Current versions of GNU binutils (2.20.1)
+@file{/usr/sfw/bin/gas}.  Current versions of GNU binutils (2.21)
 are known to work as well.  Note that your mileage may vary
 if you use a combination of the GNU tools and the Sun tools: while the
 combination GNU @command{as} + Sun @command{ld} should reasonably work,
@@ -4193,7 +4192,7 @@ 
 @c FIXME: still?
 GNU @command{ld} usually works as well, although the version included in
 Solaris 10 cannot be used due to several bugs.  Again, the current
-version (2.20.1) is known to work, but generally lacks platform specific
+version (2.21) is known to work, but generally lacks platform specific
 features, so better stay with Sun @command{ld}.
 
 To enable symbol versioning in @samp{libstdc++} with Sun @command{ld},