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:
parent
d4916912e5
commit
8c26c999b0
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue