[PATCH] Update --with-gnu-as doc entry

[Eric Botcazou <ebotcazou at libertysurf dot fr>]

Hi,

Dara pointed out a PR where a user was not passing --with-gnu-ld on 
SPARC/Solaris while the linker was GNU ld. It is mandatory to do so on this 
platform, but the docs are somewhat misleading:

--with-gnu-ld 
Same as --with-gnu-as, but for the linker. 

and the entry for --with-gnu-as says that this latter option doesn't make any 
difference on SPARC/Solaris, which leads to think that it's the same for 
--with-gnu-ld.

To sum up, --with-gnu-ld really makes a difference. Moreover, '--with-gnu-as 
doesn't make any difference' was true back in the days of SPARC32 only but, 
either with SPARC32/64 or SPARC64, this is not true anymore.

So I propose to go the conservative way and say that --with-gnu-as always 
makes a difference on SPARC/Solaris, which in turn will appear to imply the 
same assertion for --with-gnu-ld.

There is one remaining problem: should GNU ld be used if GNU as is used?
I know that this is not required on SPARC32, but don't have any clue for 
SPARC32/64 and SPARC64. Nevertheless, I chose to say no.

Finally, I removed the @uref from the --with-gnu-ld entry, which was the only 
one pointing to an option.

Tested with 'make doc' and 'install.texi2html'. Ok for mainline and 3.3 
branch?

-- 
Eric Botcazou


2003-06-13  Eric Botcazou  <ebotcazou@libertysurf.fr>

	* doc/install.texi (--with-gnu-as): Mention SPARC and SPARC64
	as platforms where --with-gnu-as makes a difference.
	(--with-gnu-ld): Remove @uref.

Index: doc/install.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/install.texi,v
retrieving revision 1.200
diff -u -r1.200 install.texi
--- doc/install.texi	12 Jun 2003 18:46:23 -0000	1.200
+++ doc/install.texi	13 Jun 2003 17:34:47 -0000
@@ -745,10 +745,12 @@
 @item @samp{m68000-att-sysv}
 @item @samp{@var{any}-lynx-lynxos}
 @item @samp{mips-@var{any}}
+@item @samp{sparc-sun-solaris2.@var{any}}
+@item @samp{sparc64-@var{any}-solaris2.@var{any}}
 @end itemize
 
-On the systems listed above (except for the HP-PA, for ISC on the
-386, and for @samp{mips-sgi-irix5.*}), if you use the GNU assembler,
+On the systems listed above (except for the HP-PA, the SPARC, for ISC on
+the 386, and for @samp{mips-sgi-irix5.*}), if you use the GNU assembler,
 you should also use the GNU linker (and specify @option{--with-gnu-ld}).
 
 @item --with-as=@var{pathname}
@@ -775,9 +777,8 @@
 and want to choose one that is not found by the above rules.
 
 @item @anchor{with-gnu-ld}--with-gnu-ld
-Same as @uref{#with-gnu-as,,@option{--with-gnu-as}}
-but for linker.
-
+Same as
+@option{--with-gnu-as}, but for the linker.
 
 @item --with-ld=@var{pathname}
 Same as