This is the mail archive of the 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] Update --with-gnu-as doc entry


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:

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 

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 

Eric Botcazou

2003-06-13  Eric Botcazou  <>

	* 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

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