install-old.texi: Remove more documentation of configure options.

* doc/install-old.texi: Remove more documentation of configure
	options.
	* doc/install.texi: Add it here.

From-SVN: r43534
This commit is contained in:
Joseph Myers 2001-06-24 00:41:59 +01:00 committed by Joseph Myers
parent d4916912e5
commit 8c26c999b0
3 changed files with 49 additions and 77 deletions

View File

@ -1,3 +1,9 @@
2001-06-24 Joseph S. Myers <jsm28@cam.ac.uk>
* doc/install-old.texi: Remove more documentation of configure
options.
* doc/install.texi: Add it here.
Sat Jun 23 19:40:05 CEST 2001 Jan Hubicka <jh@suse.cz>
* i386-protos.h (emit_i387_cw_initialization): Declare.

View File

@ -84,81 +84,6 @@ See @ref{Configurations}, for a list of supported configuration names and
notes on many of the configurations. You should check the notes in that
section before proceeding any further with the installation of GNU CC.
@item
When running @code{configure}, you may also need to specify certain
additional options that describe variant hardware and software
configurations. These are @option{--with-gnu-as}, @option{--with-gnu-ld},
@option{--with-stabs} and @option{--nfp}.
@table @samp
@item --with-gnu-as
If you will use GNU CC with the GNU assembler (GAS), you should declare
this by using the @option{--with-gnu-as} option when you run
@file{configure}.
Using this option does not install GAS. It only modifies the output of
GNU CC to work with GAS. Building and installing GAS is up to you.
Conversely, if you @emph{do not} wish to use GAS and do not specify
@option{--with-gnu-as} when building GNU CC, it is up to you to make sure
that GAS is not installed. GNU CC searches for a program named
@code{as} in various directories; if the program it finds is GAS, then
it runs GAS. If you are not sure where GNU CC finds the assembler it is
using, try specifying @option{-v} when you run it.
The systems where it makes a difference whether you use GAS are@*
@samp{hppa1.0-@var{any}-@var{any}}, @samp{hppa1.1-@var{any}-@var{any}},
@samp{i386-@var{any}-sysv}, @samp{i386-@var{any}-isc},@*
@samp{i860-@var{any}-bsd}, @samp{m68k-bull-sysv},@*
@samp{m68k-hp-hpux}, @samp{m68k-sony-bsd},@*
@samp{m68k-altos-sysv}, @samp{m68000-hp-hpux},@*
@samp{m68000-att-sysv}, @samp{@var{any}-lynx-lynxos},
and @samp{mips-@var{any}}).
On any other system, @option{--with-gnu-as} has no effect.
On the systems listed above (except for the HP-PA, for ISC on the
386, and for @samp{mips-sgi-irix5.*}), if you use GAS, you should also
use the GNU linker (and specify @option{--with-gnu-ld}).
@item --with-gnu-ld
Specify the option @option{--with-gnu-ld} if you plan to use the GNU
linker with GNU CC.
This option does not cause the GNU linker to be installed; it just
modifies the behavior of GNU CC to work with the GNU linker.
@c Specifically, it inhibits the installation of @code{collect2}, a program
@c which otherwise serves as a front end for the system's linker on most
@c configurations.
@item --with-stabs
On MIPS based systems and on Alphas, you must specify whether you want
GNU CC to create the normal ECOFF debugging format, or to use BSD-style
stabs passed through the ECOFF symbol table. The normal ECOFF debug
format cannot fully handle languages other than C. BSD stabs format can
handle other languages, but it only works with the GNU debugger GDB.
Normally, GNU CC uses the ECOFF debugging format by default; if you
prefer BSD stabs, specify @option{--with-stabs} when you configure GNU
CC.
No matter which default you choose when you configure GNU CC, the user
can use the @option{-gcoff} and @option{-gstabs+} options to specify explicitly
the debug format for a particular compilation.
@option{--with-stabs} is meaningful on the ISC system on the 386, also, if
@option{--with-gas} is used. It selects use of stabs debugging
information embedded in COFF output. This kind of debugging information
supports C++ well; ordinary COFF debugging information does not.
@option{--with-stabs} is also meaningful on 386 systems running SVR4. It
selects use of stabs debugging information embedded in ELF output. The
C++ compiler currently (2.6.0) does not support the DWARF debugging
information normally used on 386 SVR4 platforms; stabs provide a
workable alternative. This requires gas and gdb, as the normal SVR4
tools can not generate or interpret stabs.
@end table
@end enumerate
@node Configuration Files

View File

@ -33,7 +33,7 @@
@settitle Installing GCC: Binaries
@end ifset
@comment $Id: install.texi,v 1.31 2001/06/21 15:25:54 shebs Exp $
@comment $Id: install.texi,v 1.32 2001/06/21 19:00:08 pme Exp $
@c Copyright (C) 2001 Free Software Foundation, Inc.
@c *** Converted to texinfo by Dean Wakerley, dean@wakerley.com
@ -403,10 +403,26 @@ argument, only @option{--enable-shared} does.
Specify that the compiler should assume that the
assembler it finds is the GNU assembler. However, this does not modify
the rules to find an assembler and will result in confusion if found
assembler is not actually the GNU assembler. If you have more than one
assembler is not actually the GNU assembler. (Confusion will also
result if the compiler finds the GNU assembler but has not been
configured with @option{--with-gnu-as}.) If you have more than one
assembler installed on your system, you may want to use this option in
connection with @option{--with-as=@file{/path/to/gas}}.
The systems where it makes a difference whether you use the GNU assembler are
@samp{hppa1.0-@var{any}-@var{any}}, @samp{hppa1.1-@var{any}-@var{any}},
@samp{i386-@var{any}-sysv}, @samp{i386-@var{any}-isc},
@samp{i860-@var{any}-bsd}, @samp{m68k-bull-sysv},
@samp{m68k-hp-hpux}, @samp{m68k-sony-bsd},
@samp{m68k-altos-sysv}, @samp{m68000-hp-hpux},
@samp{m68000-att-sysv}, @samp{@var{any}-lynx-lynxos},
and @samp{mips-@var{any}}.
On any other system, @option{--with-gnu-as} has no effect.
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,
you should also use the GNU linker (and specify @option{--with-gnu-ld}).
@item --with-as=@file{/path/to/as}
Specify that the
compiler should use the assembler pointed to by @var{pathname}, rather
@ -444,6 +460,31 @@ Specify that stabs debugging
information should be used instead of whatever format the host normally
uses. Normally GCC uses the same debug format as the host system.
On MIPS based systems and on Alphas, you must specify whether you want
GCC to create the normal ECOFF debugging format, or to use BSD-style
stabs passed through the ECOFF symbol table. The normal ECOFF debug
format cannot fully handle languages other than C. BSD stabs format can
handle other languages, but it only works with the GNU debugger GDB.
Normally, GCC uses the ECOFF debugging format by default; if you
prefer BSD stabs, specify @option{--with-stabs} when you configure GCC.
No matter which default you choose when you configure GCC, the user
can use the @option{-gcoff} and @option{-gstabs+} options to specify explicitly
the debug format for a particular compilation.
@option{--with-stabs} is meaningful on the ISC system on the 386, also, if
@option{--with-gas} is used. It selects use of stabs debugging
information embedded in COFF output. This kind of debugging information
supports C++ well; ordinary COFF debugging information does not.
@option{--with-stabs} is also meaningful on 386 systems running SVR4. It
selects use of stabs debugging information embedded in ELF output. The
C++ compiler currently (2.6.0) does not support the DWARF debugging
information normally used on 386 SVR4 platforms; stabs provide a
workable alternative. This requires gas and gdb, as the normal SVR4
tools can not generate or interpret stabs.
@item --enable-multilib
Specify that multiple target
libraries should be built to support different target variants, calling