This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [doc] Update Solaris 2 installation documentation
Eric Botcazou <ebotcazou@adacore.com> writes:
>> Overall, the differences didn't seem to warrant a strong recommendation
>> for gas to me.
>
> Maybe, but not the opposite one either, assuming "eventually" is meant for "as
> a second choice" here. So I'd say something like: "We recommend the use of
> the Sun assembler or the GNU assembler, in conjunction with the Sun linker."
Agreed.
>> Thanks for the suggestions. I'll commit the updates once we've come to
>> an agreement about the gas questions. From Richard's freeze message, I
>> understand that doc fixes are still ok for the branch now, although
>> gcc.gnu.org states `all changes require release-manager approval',
>> right?
>
> I presume so.
Ok. Here's the patch I'd like to commit to trunk and 4.5 branch unless
there are further comments or corrections.
As usual, passed make doc/gccinstall.info and make doc/install.dvi.
Rainer
--
-----------------------------------------------------------------------------
Rainer Orth, Center for Biotechnology, Bielefeld University
2010-04-06 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
* doc/install.texi (Specific, i?86-*-solaris2.10): Fix grammar.
(Specific, *-*-solaris2*): Likewise.
Don't prefer Sun as over GNU as.
diff -r 28c48e5c1a1e gcc/doc/install.texi
--- a/gcc/doc/install.texi Tue Apr 06 22:59:25 2010 +0200
+++ b/gcc/doc/install.texi Wed Apr 07 12:53:30 2010 +0200
@@ -3477,7 +3477,7 @@
It is recommended that you configure GCC to use the GNU assembler, in
@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 latest (as of 2010-04-01) version, from GNU binutils
+although the current version, from GNU binutils
2.20.1, 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?
@@ -4132,18 +4132,18 @@
have @file{/usr/xpg4/bin} in your @env{PATH}, we recommend that you place
@file{/usr/bin} before @file{/usr/xpg4/bin} for the duration of the build.
-We recommend the use of the vendor tools (Sun @command{as}, Sun
-@command{ld}), or eventually GNU @command{as}. The GNU @command{as}
+We recommend the use of the Sun assembler or the GNU assembler, in
+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 as of
-2010-04-01) are known work either. Note that your mileage may vary
+@file{/usr/sfw/bin/gas}. Current versions of GNU binutils (2.20.1)
+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,
the reverse combination Sun @command{as} + GNU @command{ld} is known to
cause memory corruption at runtime in some cases for C++ programs.
@c FIXME: still?
-GNU @command{ld} usually works either, though the version included in
+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
features, so better stay with Sun @command{ld}.