--- illumos-gcc-0f5ed4c/gcc/doc/install.texi.orig +++ illumos-gcc-0f5ed4c/gcc/doc/install.texi @@ -2746,7 +2746,8 @@
@end html -@heading @anchor{alpha-x-x}alpha*-*-* +@anchor{alpha-x-x} +@heading alpha*-*-* This section contains general configuration information for all alpha-based platforms using ELF (in particular, ignore this section for @@ -2761,7 +2762,8 @@ @html
@end html -@heading @anchor{alpha-dec-osf}alpha*-dec-osf* +@anchor{alpha-dec-osf} +@heading alpha*-dec-osf* Systems using processors that implement the DEC Alpha architecture and are running the DEC/Compaq Unix (DEC OSF/1, Digital UNIX, or Compaq Tru64 UNIX) operating system, for example the DEC Alpha AXP systems. @@ -2834,14 +2836,16 @@ @html
@end html -@heading @anchor{arc-x-elf}arc-*-elf +@anchor{arc-x-elf} +@heading arc-*-elf Argonaut ARC processor. This configuration is intended for embedded systems. @html
@end html -@heading @anchor{arm-x-elf}arm-*-elf +@anchor{arm-x-elf} +@heading arm-*-elf ARM-family processors. Subtargets that use the ELF object format require GNU binutils 2.13 or newer. Such subtargets include: @code{arm-*-freebsd}, @code{arm-*-netbsdelf}, @code{arm-*-*linux} @@ -2850,7 +2854,8 @@ @html
@end html -@heading @anchor{arm-x-coff}arm-*-coff +@anchor{arm-x-coff} +@heading arm-*-coff ARM-family processors. Note that there are two different varieties of PE format subtarget supported: @code{arm-wince-pe} and @code{arm-pe} as well as a standard COFF target @code{arm-*-coff}. @@ -2858,14 +2863,16 @@ @html
@end html -@heading @anchor{arm-x-aout}arm-*-aout +@anchor{arm-x-aout} +@heading arm-*-aout ARM-family processors. These targets support the AOUT file format: @code{arm-*-aout}, @code{arm-*-netbsd}. @html
@end html -@heading @anchor{avr}avr +@anchor{avr} +@heading avr ATMEL AVR-family micro controllers. These are used in embedded applications. There are no standard Unix configurations. @@ -2902,7 +2909,8 @@ @html
@end html -@heading @anchor{bfin}Blackfin +@anchor{bfin} +@heading Blackfin The Blackfin processor, an Analog Devices DSP. @ifnothtml @@ -2919,7 +2927,8 @@ @html
@end html -@heading @anchor{cris}CRIS +@anchor{cris} +@heading CRIS CRIS is the CPU architecture in Axis Communications ETRAX system-on-a-chip series. These are used in embedded applications. @@ -2954,7 +2963,8 @@ @html
@end html -@heading @anchor{crx}CRX +@anchor{crx} +@heading CRX The CRX CompactRISC architecture is a low-power 32-bit architecture with fast context switching and architectural extensibility features. @@ -2980,7 +2990,8 @@ @html
@end html -@heading @anchor{dos}DOS +@anchor{dos} +@heading DOS Please have a look at the @uref{binaries.html,,binaries page}. @@ -2992,7 +3003,8 @@ @html
@end html -@heading @anchor{x-x-freebsd}*-*-freebsd* +@anchor{x-x-freebsd} +@heading *-*-freebsd* The version of binutils installed in @file{/usr/bin} probably works with this release of GCC@. However, on FreeBSD 4, bootstrapping against the @@ -3040,7 +3052,8 @@ @html
@end html -@heading @anchor{h8300-hms}h8300-hms +@anchor{h8300-hms} +@heading h8300-hms Renesas H8/300 series of processors. Please have a look at the @uref{binaries.html,,binaries page}. @@ -3053,7 +3066,8 @@ @html
@end html -@heading @anchor{hppa-hp-hpux}hppa*-hp-hpux* +@anchor{hppa-hp-hpux} +@heading hppa*-hp-hpux* Support for HP-UX version 9 and older was discontinued in GCC 3.4. We require using gas/binutils on all hppa platforms. Version 2.19 or @@ -3105,7 +3119,8 @@ @html
@end html -@heading @anchor{hppa-hp-hpux10}hppa*-hp-hpux10 +@anchor{hppa-hp-hpux10} +@heading hppa*-hp-hpux10 For hpux10.20, we @emph{highly} recommend you pick up the latest sed patch @code{PHCO_19798} from HP@. HP has two sites which provide patches free of @@ -3133,7 +3148,8 @@ @html
@end html -@heading @anchor{hppa-hp-hpux11}hppa*-hp-hpux11 +@anchor{hppa-hp-hpux11} +@heading hppa*-hp-hpux11 GCC 3.0 and up support HP-UX 11. GCC 2.95.x is not supported and cannot be used to compile GCC 3.0 and up. @@ -3244,7 +3260,8 @@ @html
@end html -@heading @anchor{x-x-linux-gnu}*-*-linux-gnu +@anchor{x-x-linux-gnu} +@heading *-*-linux-gnu Versions of libstdc++-v3 starting with 3.2.1 require bug fixes present in glibc 2.2.5 and later. More information is available in the @@ -3253,7 +3270,8 @@ @html
@end html -@heading @anchor{ix86-x-linux}i?86-*-linux* +@anchor{ix86-x-linux} +@heading i?86-*-linux* As of GCC 3.3, binutils 2.13.1 or later is required for this platform. See @uref{http://gcc.gnu.org/PR10877,,bug 10877} for more information. @@ -3265,7 +3283,8 @@ @html
@end html -@heading @anchor{ix86-x-solaris210}i?86-*-solaris2.10 +@anchor{ix86-x-solaris210} +@heading i?86-*-solaris2.10 Use this for Solaris 10 or later on x86 and x86-64 systems. This configuration is supported by GCC 4.0 and later versions only. @@ -3277,7 +3296,8 @@ @html
@end html -@heading @anchor{ia64-x-linux}ia64-*-linux +@anchor{ia64-x-linux} +@heading ia64-*-linux IA-64 processor (also known as IPF, or Itanium Processor Family) running GNU/Linux. @@ -3297,7 +3317,8 @@ @html
@end html -@heading @anchor{ia64-x-hpux}ia64-*-hpux* +@anchor{ia64-x-hpux} +@heading ia64-*-hpux* Building GCC on this target requires the GNU Assembler. The bundled HP assembler will not work. To prevent GCC from using the wrong assembler, the option @option{--with-gnu-as} may be necessary. @@ -3312,7 +3333,8 @@
@end html -@heading @anchor{x-ibm-aix}*-ibm-aix* +@anchor{x-ibm-aix} +@heading *-ibm-aix* Support for AIX version 3 and older was discontinued in GCC 3.4. ``out of memory'' bootstrap failures may indicate a problem with @@ -3443,42 +3465,48 @@ @html
@end html -@heading @anchor{iq2000-x-elf}iq2000-*-elf +@anchor{iq2000-x-elf} +@heading iq2000-*-elf Vitesse IQ2000 processors. These are used in embedded applications. There are no standard Unix configurations. @html
@end html -@heading @anchor{m32c-x-elf}m32c-*-elf +@anchor{m32c-x-elf} +@heading m32c-*-elf Renesas M32C processor. This configuration is intended for embedded systems. @html
@end html -@heading @anchor{m32r-x-elf}m32r-*-elf +@anchor{m32r-x-elf} +@heading m32r-*-elf Renesas M32R processor. This configuration is intended for embedded systems. @html
@end html -@heading @anchor{m6811-elf}m6811-elf +@anchor{m6811-elf} +@heading m6811-elf Motorola 68HC11 family micro controllers. These are used in embedded applications. There are no standard Unix configurations. @html
@end html -@heading @anchor{m6812-elf}m6812-elf +@anchor{m6812-elf} +@heading m6812-elf Motorola 68HC12 family micro controllers. These are used in embedded applications. There are no standard Unix configurations. @html
@end html -@heading @anchor{m68k-x-x}m68k-*-* +@anchor{m68k-x-x} +@heading m68k-*-* By default, @samp{m68k-*-aout}, @samp{m68k-*-coff*}, @samp{m68k-*-elf*}, @samp{m68k-*-rtems}, @samp{m68k-*-uclinux} and @samp{m68k-*-linux} @@ -3504,7 +3532,8 @@ @html
@end html -@heading @anchor{m68k-x-uclinux}m68k-*-uclinux +@anchor{m68k-x-uclinux} +@heading m68k-*-uclinux GCC 4.3 changed the uClinux configuration so that it uses the @samp{m68k-linux-gnu} ABI rather than the @samp{m68k-elf} ABI. It also added improved support for C++ and flat shared libraries, @@ -3515,7 +3544,8 @@ @html
@end html -@heading @anchor{mips-x-x}mips-*-* +@anchor{mips-x-x} +@heading mips-*-* If on a MIPS system you get an error message saying ``does not have gp sections for all it's [sic] sectons [sic]'', don't worry about it. This happens whenever you use GAS with the MIPS linker, but there is not @@ -3573,7 +3603,8 @@ @html
@end html -@heading @anchor{mips-sgi-irix5}mips-sgi-irix5 +@anchor{mips-sgi-irix5} +@heading mips-sgi-irix5 In order to compile GCC on an SGI running IRIX 5, the @samp{compiler_dev.hdr} subsystem must be installed from the IDO CD-ROM supplied by SGI@. @@ -3603,7 +3634,8 @@ @html
@end html -@heading @anchor{mips-sgi-irix6}mips-sgi-irix6 +@anchor{mips-sgi-irix6} +@heading mips-sgi-irix6 If you are using SGI's MIPSpro @command{cc} as your bootstrap compiler, you must ensure that the N32 ABI is in use. To test this, compile a simple C @@ -3687,7 +3719,8 @@ @html
@end html -@heading @anchor{powerpc-x-x}powerpc-*-* +@anchor{powerpc-x-x} +@heading powerpc-*-* You can specify a default version for the @option{-mcpu=@var{cpu_type}} switch by using the configure option @option{--with-cpu-@var{cpu_type}}. @@ -3699,7 +3732,8 @@ @html
@end html -@heading @anchor{powerpc-x-darwin}powerpc-*-darwin* +@anchor{powerpc-x-darwin} +@heading powerpc-*-darwin* PowerPC running Darwin (Mac OS X kernel). Pre-installed versions of Mac OS X may not include any developer tools, @@ -3716,70 +3750,81 @@ @html
@end html -@heading @anchor{powerpc-x-elf}powerpc-*-elf +@anchor{powerpc-x-elf} +@heading powerpc-*-elf PowerPC system in big endian mode, running System V.4. @html
@end html -@heading @anchor{powerpc-x-linux-gnu}powerpc*-*-linux-gnu* +@anchor{powerpc-x-linux-gnu} +@heading powerpc*-*-linux-gnu* PowerPC system in big endian mode running Linux. @html
@end html -@heading @anchor{powerpc-x-netbsd}powerpc-*-netbsd* +@anchor{powerpc-x-netbsd} +@heading powerpc-*-netbsd* PowerPC system in big endian mode running NetBSD@. @html
@end html -@heading @anchor{powerpc-x-eabisim}powerpc-*-eabisim +@anchor{powerpc-x-eabisim} +@heading powerpc-*-eabisim Embedded PowerPC system in big endian mode for use in running under the PSIM simulator. @html
@end html -@heading @anchor{powerpc-x-eabi}powerpc-*-eabi +@anchor{powerpc-x-eabi} +@heading powerpc-*-eabi Embedded PowerPC system in big endian mode. @html
@end html -@heading @anchor{powerpcle-x-elf}powerpcle-*-elf +@anchor{powerpcle-x-elf} +@heading powerpcle-*-elf PowerPC system in little endian mode, running System V.4. @html
@end html -@heading @anchor{powerpcle-x-eabisim}powerpcle-*-eabisim +@anchor{powerpcle-x-eabisim} +@heading powerpcle-*-eabisim Embedded PowerPC system in little endian mode for use in running under the PSIM simulator. @html
@end html -@heading @anchor{powerpcle-x-eabi}powerpcle-*-eabi +@anchor{powerpcle-x-eabi} +@heading powerpcle-*-eabi Embedded PowerPC system in little endian mode. @html
@end html -@heading @anchor{s390-x-linux}s390-*-linux* +@anchor{s390-x-linux} +@heading s390-*-linux* S/390 system running GNU/Linux for S/390@. @html
@end html -@heading @anchor{s390x-x-linux}s390x-*-linux* +@anchor{s390x-x-linux} +@heading s390x-*-linux* zSeries system (64-bit) running GNU/Linux for zSeries@. @html
@end html -@heading @anchor{s390x-ibm-tpf}s390x-ibm-tpf* +@anchor{s390x-ibm-tpf} +@heading s390x-ibm-tpf* zSeries system (64-bit) running TPF@. This platform is supported as cross-compilation target only. @@ -3790,7 +3835,8 @@ @c with 2.0 until 2.6, 7, 8, etc. Solaris 1 was a marketing name for @c SunOS 4 releases which we don't use to avoid confusion. Solaris @c alone is too unspecific and must be avoided. -@heading @anchor{x-x-solaris2}*-*-solaris2* +@anchor{x-x-solaris2} +@heading *-*-solaris2* Sun does not ship a C compiler with Solaris 2. To bootstrap and install GCC you first have to install a pre-built compiler, see the @@ -3880,7 +3926,8 @@ @html
@end html -@heading @anchor{sparc-sun-solaris2}sparc-sun-solaris2* +@anchor{sparc-sun-solaris2} +@heading sparc-sun-solaris2* When GCC is configured to use binutils 2.14 or later the binaries produced are smaller than the ones produced using Sun's native tools; @@ -3942,7 +3989,8 @@ @html
@end html -@heading @anchor{sparc-sun-solaris27}sparc-sun-solaris2.7 +@anchor{sparc-sun-solaris27} +@heading sparc-sun-solaris2.7 Sun patch 107058-01 (1999-01-13) for Solaris 7/SPARC triggers a bug in the dynamic linker. This problem (Sun bug 4210064) affects GCC 2.8 @@ -4004,7 +4052,8 @@ @html
@end html -@heading @anchor{sparc-x-linux}sparc-*-linux* +@anchor{sparc-x-linux} +@heading sparc-*-linux* GCC versions 3.0 and higher require binutils 2.11.2 and glibc 2.2.4 or newer on this platform. All earlier binutils and glibc @@ -4014,7 +4063,8 @@ @html
@end html -@heading @anchor{sparc64-x-solaris2}sparc64-*-solaris2* +@anchor{sparc64-x-solaris2} +@heading sparc64-*-solaris2* When configuring the GNU Multiple Precision Library (GMP) or the MPFR library, the canonical target triplet must be specified as @@ -4038,14 +4088,16 @@ @html
@end html -@heading @anchor{sparcv9-x-solaris2}sparcv9-*-solaris2* +@anchor{sparcv9-x-solaris2} +@heading sparcv9-*-solaris2* This is a synonym for sparc64-*-solaris2*. @html
@end html -@heading @anchor{x-x-vxworks}*-*-vxworks* +@anchor{x-x-vxworks} +@heading *-*-vxworks* Support for VxWorks is in flux. At present GCC supports @emph{only} the very recent VxWorks 5.5 (aka Tornado 2.2) release, and only on PowerPC@. We welcome patches for other architectures supported by VxWorks 5.5. @@ -4080,7 +4132,8 @@ @html
@end html -@heading @anchor{x86-64-x-x}x86_64-*-*, amd64-*-* +@anchor{x86-64-x-x} +@heading x86_64-*-*, amd64-*-* GCC supports the x86-64 architecture implemented by the AMD64 processor (amd64-*-* is an alias for x86_64-*-*) on GNU/Linux, FreeBSD and NetBSD@. @@ -4090,7 +4143,8 @@ @html
@end html -@heading @anchor{xtensa-x-elf}xtensa*-*-elf +@anchor{xtensa-x-elf} +@heading xtensa*-*-elf This target is intended for embedded Xtensa systems using the @samp{newlib} C library. It uses ELF but does not support shared @@ -4108,7 +4162,8 @@ @html
@end html -@heading @anchor{xtensa-x-linux}xtensa*-*-linux* +@anchor{xtensa-x-linux} +@heading xtensa*-*-linux* This target is for Xtensa systems running GNU/Linux. It supports ELF shared objects and the GNU C library (glibc). It also generates @@ -4120,7 +4175,8 @@ @html
@end html -@heading @anchor{windows}Microsoft Windows +@anchor{windows} +@heading Microsoft Windows @subheading Intel 16-bit versions The 16-bit versions of Microsoft Windows, such as Windows 3.1, are not @@ -4177,7 +4233,8 @@ @html
@end html -@heading @anchor{x-x-cygwin}*-*-cygwin +@anchor{x-x-cygwin} +@heading *-*-cygwin Ports of GCC are included with the @uref{http://www.cygwin.com/,,Cygwin environment}. @@ -4190,7 +4247,8 @@ @html
@end html -@heading @anchor{x-x-interix}*-*-interix +@anchor{x-x-interix} +@heading *-*-interix The Interix target is used by OpenNT, Interix, Services For UNIX (SFU), and Subsystem for UNIX-based Applications (SUA). Applications compiled @@ -4202,7 +4260,8 @@ @html
@end html -@heading @anchor{x-x-mingw32}*-*-mingw32 +@anchor{x-x-mingw32} +@heading *-*-mingw32 GCC will build with and support only MinGW runtime 3.12 and later. Earlier versions of headers are incompatible with the new default semantics @@ -4211,7 +4270,8 @@ @html
@end html -@heading @anchor{os2}OS/2 +@anchor{os2} +@heading OS/2 GCC does not currently support OS/2. However, Andrew Zabolotny has been working on a generic OS/2 port with pgcc. The current code can be found @@ -4220,7 +4280,8 @@ @html
@end html -@heading @anchor{older}Older systems +@anchor{older} +@heading Older systems GCC contains support files for many older (1980s and early 1990s) Unix variants. For the most part, support for these systems @@ -4266,7 +4327,8 @@ @html
@end html -@heading @anchor{elf}all ELF targets (SVR4, Solaris 2, etc.) +@anchor{elf} +@heading all ELF targets (SVR4, Solaris 2, etc.) C++ support is significantly better on ELF targets if you use the @uref{./configure.html#with-gnu-ld,,GNU linker}; duplicate copies of